gilles/claude-code-best-practice
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

added workflows for claude commands and skills

Browse Source
This commit is contained in:
Shayan Rais
2026-03-13 16:18:06 +05:00
parent d93c1229f7
commit d30ec3b8c7
9 changed files with 545 additions and 301 deletions
Download Patch File Download Diff File Expand all files Collapse all files
best-practice/claude-skills.md
+13 -122
View File
@@ -1,9 +1,9 @@
# Skills Best Practice
![Last Updated](https://img.shields.io/badge/Last_Updated-Mar_2%2C_2026-white?style=flat&labelColor=555)<br>
![Last Updated](https://img.shields.io/badge/Last_Updated-Mar%2013%2C%202026-white?style=flat&labelColor=555)<br>
[![Implemented](https://img.shields.io/badge/Implemented-2ea44f?style=flat)](../implementation/claude-skills-implementation.md)
Complete reference for Claude Code skills — skill definitions, frontmatter fields, and invocation patterns.
Claude Code skills — frontmatter fields and official bundled skills.
<table width="100%">
<tr>
@@ -14,9 +14,7 @@ Complete reference for Claude Code skills — skill definitions, frontmatter fie
---
## Frontmatter Fields
Skills are defined in `.claude/skills/<name>/SKILL.md` with optional YAML frontmatter.
## Frontmatter Fields (10)
| Field | Type | Required | Description |
|-------|------|----------|-------------|
@@ -33,125 +31,18 @@ Skills are defined in `.claude/skills/<name>/SKILL.md` with optional YAML frontm
---
## Two Skill Patterns
## ![Official](../!/tags/official.svg) **(6)**
| Pattern | Loading | Invocation | Use Case |
|---------|---------|-----------|----------|
| **Skill** | On-demand | `/skill-name` or `Skill(skill: "name")` tool | Standalone reusable workflows invoked by commands or Claude |
| **Agent Skill** | Preloaded at agent startup via `skills:` field | Automatic — full content injected into agent context | Domain knowledge or procedures baked into a specific agent |
| # | 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 |
| 6 | `keybindings-help` | Customize keyboard shortcuts, rebind keys, and create chord sequences |
---
## String Substitutions
Available inside skill markdown for dynamic values:
| Variable | Description |
|----------|-------------|
| `$ARGUMENTS` | All arguments passed when invoking the skill |
| `$ARGUMENTS[N]` | Access a specific argument by 0-based index |
| `$N` | Shorthand for `$ARGUMENTS[N]` (e.g., `$0`, `$1`) |
| `${CLAUDE_SESSION_ID}` | Current session identifier |
| `` !`command` `` | Dynamic context injection — shell command output replaces the placeholder before Claude sees it |
---
## Invocation
| Method | Description |
|--------|-------------|
| `/skill-name` | Invoke directly from the slash command menu |
| `/skill-name [args]` | Pass arguments that map to `$ARGUMENTS` |
| `Skill(skill: "name")` | Programmatic invocation via the Skill tool (used in commands and agents) |
| `skills: [name]` in agent frontmatter | Preload into an agent — full skill content injected at startup, not invoked on-demand |
| Subdirectories | Skills in subdirectories use `/subdir:skill-name` |
---
## Example: Minimal Skill
```yaml
---
description: Summarize staged changes into a concise changelog entry
---
Summarize the git diff in context into a one-paragraph changelog entry,
focusing on what changed and why.
```
## Example: Minimal Agent Skill
A skill preloaded into an agent as background knowledge — hidden from the `/` menu:
```yaml
---
name: deploy-checklist
description: Pre-flight deployment checks for production releases
user-invocable: false
---
# Deploy Checklist
Before any production deployment:
1. Run all tests: `npm test`
2. Check for uncommitted changes: `git status`
3. Verify environment variables are set
4. Confirm database migrations are ready
```
## Example: Full-Featured Skill (All Fields)
```yaml
---
name: code-review
description: Review code for quality, security, and performance issues
argument-hint: [file-path]
allowed-tools: Read, Grep, Glob
model: sonnet
context: fork
agent: general-purpose
hooks:
Stop:
- hooks:
- type: command
command: "./scripts/log-review-complete.sh"
---
Review the code at $0.
## Checklist
- [ ] Security: injection, XSS, hardcoded secrets
- [ ] Performance: N+1 queries, unnecessary loops
- [ ] Quality: naming, complexity, test coverage
- [ ] Error handling: edge cases, failure modes
```
---
## Scope and Priority
When multiple skills share the same name, the higher-priority location wins:
| Location | Scope | Priority |
|----------|-------|----------|
| Project (`.claude/skills/`) | This project only | 1 (highest) |
| Personal (`~/.claude/skills/`) | All your projects | 2 |
| Plugin (`<plugin>/skills/`) | Where plugin is enabled | 3 (lowest) |
---
## Skills in This Repository
Skills defined in `.claude/skills/` for this project:
| Skill | User-Invocable | Preloaded Into | Description |
|-------|----------------|----------------|-------------|
| [`weather-svg-creator`](../.claude/skills/weather-svg-creator/SKILL.md) | Yes | — | Creates SVG weather card and writes output files |
| [`weather-fetcher`](../.claude/skills/weather-fetcher/SKILL.md) | No | `weather-agent` | Fetches current temperature from Open-Meteo |
| [`agent-browser`](../.claude/skills/agent-browser/SKILL.md) | Yes | — | Browser automation CLI for AI agents |
| [`presentation/vibe-to-agentic-framework`](../.claude/skills/presentation/vibe-to-agentic-framework/SKILL.md) | Yes | `presentation-curator` | Conceptual framework behind the presentation |
| [`presentation/presentation-structure`](../.claude/skills/presentation/presentation-structure/SKILL.md) | Yes | `presentation-curator` | Slide format, weight system, and section structure |
| [`presentation/presentation-styling`](../.claude/skills/presentation/presentation-styling/SKILL.md) | Yes | `presentation-curator` | CSS classes, component patterns, and syntax highlighting |
See also: [Official Skills Repository](https://github.com/anthropics/skills/tree/main/skills) for community-maintained installable skills.
---