Shayan Rais
d913b37cca
Settings report: add editorMode to ~/.claude.json table, move showClearContextOnPlanAccept to settings.json (confirmed on official page), fix terminalProgressBarEnabled terminals, add Config tool to availableModels. README: add /schedule cloud-based scheduled tasks alongside /loop, update development workflow stars (Superpowers 107k, ECC 101k, gstack 41k, GSD 40k), update counts for ECC, gstack, GSD, OpenSpec. All other reports (commands, skills, subagents, concepts) synced with no drift. Co-Authored-By: Claude <noreply@anthropic.com>
54 lines
2.7 KiB
Markdown
54 lines
2.7 KiB
Markdown
# Skills Best Practice
|
|
|
|
<br>
|
|
[](../implementation/claude-skills-implementation.md)
|
|
|
|
Claude Code skills — frontmatter fields and official bundled skills.
|
|
|
|
<table width="100%">
|
|
<tr>
|
|
<td><a href="../">← Back to Claude Code Best Practice</a></td>
|
|
<td align="right"><img src="../!/claude-jumping.svg" alt="Claude" width="60" /></td>
|
|
</tr>
|
|
</table>
|
|
|
|
---
|
|
|
|
## Frontmatter Fields (11)
|
|
|
|
| Field | Type | Required | Description |
|
|
|-------|------|----------|-------------|
|
|
| `name` | string | No | Display name and `/slash-command` identifier. Defaults to the directory name if omitted |
|
|
| `description` | string | Recommended | What the skill does. Shown in autocomplete and used by Claude for auto-discovery |
|
|
| `argument-hint` | string | No | Hint shown during autocomplete (e.g., `[issue-number]`, `[filename]`) |
|
|
| `disable-model-invocation` | boolean | No | Set `true` to prevent Claude from automatically invoking this skill |
|
|
| `user-invocable` | boolean | No | Set `false` to hide from the `/` menu — skill becomes background knowledge only, intended for agent preloading |
|
|
| `allowed-tools` | string | No | Tools allowed without permission prompts when this skill is active |
|
|
| `model` | string | No | Model to use when this skill runs (e.g., `haiku`, `sonnet`, `opus`) |
|
|
| `effort` | string | No | Override the model effort level when invoked (`low`, `medium`, `high`, `max`) |
|
|
| `context` | string | No | Set to `fork` to run the skill in an isolated subagent context |
|
|
| `agent` | string | No | Subagent type when `context: fork` is set (default: `general-purpose`) |
|
|
| `hooks` | object | No | Lifecycle hooks scoped to this skill |
|
|
|
|
---
|
|
|
|
##  **(5)**
|
|
|
|
| # | Skill | Description |
|
|
|---|-------|-------------|
|
|
| 1 | `simplify` | Review changed code for reuse, quality, and efficiency — refactors to eliminate duplication |
|
|
| 2 | `batch` | Run commands across multiple files in bulk |
|
|
| 3 | `debug` | Debug failing commands or code issues |
|
|
| 4 | `loop` | Run a prompt or slash command on a recurring interval (up to 3 days) |
|
|
| 5 | `claude-api` | Build apps with the Claude API or Anthropic SDK — triggers on `anthropic` / `@anthropic-ai/sdk` imports |
|
|
|
|
See also: [Official Skills Repository](https://github.com/anthropics/skills/tree/main/skills) for community-maintained installable skills.
|
|
|
|
---
|
|
|
|
## Sources
|
|
|
|
- [Claude Code Skills — Docs](https://code.claude.com/docs/en/skills)
|
|
- [Skills Discovery in Monorepos](../reports/claude-skills-for-larger-mono-repos.md)
|
|
- [Claude Code CHANGELOG](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md)
|