Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
bfollington avatar

Skill Management

  • 15 installs
  • 52 repo stars
  • Updated March 4, 2026
  • bfollington/terma

skill-management is a Claude Code skill that is a quick reference for creating, updating, and managing SKILL.md files and slash commands.

About

skill-management is a Claude Code skill that serves as a quick reference for creating, updating, and managing skills. It documents skill locations, SKILL.md frontmatter fields, string substitutions, invocation control, subagent execution, and permissions. A developer uses it when working with SKILL.md files, slash commands, or extending Claude's capabilities.

  • Quick reference for creating, updating, and managing Claude Code skills
  • Documents SKILL.md frontmatter, locations, and invocation control
  • Covers subagent execution, dynamic context injection, and permissions

Skill Management by the numbers

  • 15 all-time installs (skills.sh)
  • Ranked #482 of 782 Skill Development skills by installs in the Skillselion catalog
  • Data as of Jul 28, 2026 (Skillselion catalog sync)
At a glance

skill-management capabilities & compatibility

Capabilities
documentation · orchestration
Use cases
documentation · orchestration
From the docs

What skill-management says it does

Create, update, and manage Claude Code skills. Use when working with SKILL.md files, slash commands, or extending Claude's capabilities.
SKILL.md
Keep SKILL.md under 500 lines; move detailed reference to separate files.
SKILL.md
Priority: enterprise > personal > project. Plugin skills use `plugin:skill` namespace.
SKILL.md
npx skills add https://github.com/bfollington/terma --skill skill-management

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs15
repo stars52
Last updatedMarch 4, 2026
Repositorybfollington/terma

What it does

Reference SKILL.md structure and options when creating or managing Claude Code skills.

Who is it for?

Looking up SKILL.md frontmatter, invocation control, and skill locations.

When should I use this skill?

You are working with SKILL.md files, slash commands, or extending Claude's capabilities.

What you get

Correctly structured SKILL.md files with appropriate frontmatter, invocation control, and permissions.

  • SKILL.md files
  • slash commands

By the numbers

  • Keep SKILL.md under 500 lines
  • Skill budget is 2% of the context window

Files

SKILL.mdMarkdownGitHub ↗

Skills Quick Reference

Full docs: https://code.claude.com/docs/en/skills.md

Skill Locations

LocationPathScope
Personal~/.claude/skills/<name>/SKILL.mdAll your projects
Project.claude/skills/<name>/SKILL.mdThis project only
Plugin<plugin>/skills/<name>/SKILL.mdWhere enabled
EnterpriseManaged settingsAll org users

Priority: enterprise > personal > project. Plugin skills use plugin:skill namespace.

Directory Structure

my-skill/
├── SKILL.md           # Required - main instructions
├── reference.md       # Optional - detailed docs (loaded on demand)
├── examples/          # Optional - example outputs
└── scripts/           # Optional - executable scripts

Keep SKILL.md under 500 lines; move detailed reference to separate files.

Frontmatter Reference

---
name: skill-name                    # Display name (defaults to directory name)
description: What it does           # RECOMMENDED - helps Claude decide when to use
argument-hint: [issue-number]       # Shown in autocomplete
disable-model-invocation: true      # Only user can invoke via /name
user-invocable: false               # Only Claude can invoke (hidden from / menu)
allowed-tools: Read, Grep, Glob     # Restrict tool access
model: opus                         # Model override (sonnet, opus, haiku)
context: fork                       # Run in isolated subagent
agent: Explore                      # Subagent type when context: fork
hooks: ...                          # Skill-scoped hooks
---

All fields optional. Only description is recommended.

String Substitutions

Formatting purposes: all times it would be ! I have written ❗️.

VariableDescription
$ARGUMENTSAll arguments passed to skill
$ARGUMENTS[N] / $NSpecific argument (0-indexed)
${CLAUDE_SESSION_ID}Current session ID
` ❗️command `Dynamic injection - runs before sending

If $ARGUMENTS not in content, args appended as ARGUMENTS: <value>.

Invocation Control

SettingUser invokesClaude invokesIn context
(default)YesYesDescription
disable-model-invocation: trueYesNoNot loaded
user-invocable: falseNoYesDescription

Subagent Execution

Add context: fork to run in isolation. Skill content becomes the subagent's task.

---
name: deep-research
context: fork
agent: Explore        # or Plan, general-purpose, or custom agent name
---
Research $ARGUMENTS thoroughly...

Built-in agents: Explore, Plan, general-purpose. Custom agents from .claude/agents/.

Dynamic Context Injection

Shell commands run BEFORE content sent to Claude:

---
name: pr-summary
---
PR diff: ❗️`gh pr diff`
PR comments: ❗️`gh pr view --comments`

Summarize this PR...

Extended Thinking

Include "ultrathink" anywhere in skill content to enable extended thinking.

Common Patterns

Reference skill (conventions/guidelines):

---
name: api-conventions
description: API design patterns for this codebase
---
When writing API endpoints:
- Use RESTful naming
- Return consistent error formats

Task skill (user-triggered action):

---
name: deploy
description: Deploy to production
disable-model-invocation: true
context: fork
---
Deploy $ARGUMENTS:
1. Run tests
2. Build
3. Push to deployment target

Read-only skill (restricted tools):

---
name: safe-reader
description: Explore without modifying
allowed-tools: Read, Grep, Glob
---

Permissions

Restrict in /permissions:

  • Skill - deny all skills
  • Skill(name) - exact match
  • Skill(name *) - prefix match with args

Troubleshooting

  • Skill not triggering: Check description keywords, verify with "What skills are available?"
  • Triggers too often: Make description more specific or add disable-model-invocation: true
  • Missing skills: Budget is 2% of context window. Set SLASH_COMMAND_TOOL_CHAR_BUDGET to override.

Related skills

FAQ

Where do skills live?

Personal at ~/.claude/skills, project at .claude/skills, plus plugin and enterprise locations, with priority enterprise > personal > project.

How do you control who can invoke a skill?

Frontmatter flags like disable-model-invocation and user-invocable control whether the user, Claude, or both can invoke it.

Skill Developmentagentsautomation

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.