htlin222/add-skill
claude.symlink/skills/add-skill/SKILL.md
Create new Claude Code skills with proper structure. Use when user wants to add a skill, create a slash command, or automate a workflow. Fetches official docs and guides through skill creation.
$ install --global
skillsauthnpx skillsauth add htlin222/dotfiles add-skillInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 5, 2026, 8:05 PM10.0s1 file scanned
SKILL.md
- name:
- add-skill
- description:
- Create new Claude Code skills with proper structure. Use when user wants to add a skill, create a slash command, or automate a workflow. Fetches official docs and guides through skill creation.
Add Skill (Meta Skill)
Create new Claude Code skills by fetching the latest official documentation and generating properly structured skill files.
Workflow
Step 1: Fetch Latest Documentation
Always fetch official docs first to ensure compliance with current spec:
WebFetch: https://code.claude.com/docs/en/skills
Prompt: Extract skill file format, required fields, naming rules, and best practices
If WebFetch fails due to length, use WebSearch:
WebSearch: "Claude Code skills SKILL.md format site:code.claude.com"
Step 2: Gather Requirements
Ask user (use AskUserQuestion tool):
- Name: What should this skill be called? (lowercase, hyphens only)
- Purpose: What does it do? (1-2 sentences)
- Trigger: When should Claude use it? (keywords, scenarios)
- Complexity: Does it need scripts, or just instructions?
Step 3: Create Skill Structure
~/.claude/skills/{skill-name}/
├── SKILL.md # Required: Main instructions
├── scripts/ # Optional: Executable code
└── references/ # Optional: Detailed documentation
Step 4: Generate SKILL.md
Use this template:
---
name: {skill-name}
description: {What it does}. Use when {trigger conditions}.
---
# {Skill Title}
{Brief overview - what this skill helps accomplish}
## When to Use
- {Scenario 1}
- {Scenario 2}
## Instructions
{Step-by-step guidance for Claude to follow}
## Examples
**Input:** {example user request}
**Output:** {expected Claude behavior}
Step 5: Validate
Before creating, verify:
- [ ] Name: 1-64 chars, lowercase letters/numbers/hyphens only
- [ ] Name: No leading/trailing
-, no consecutive-- - [ ] Description: States WHAT + WHEN clearly
- [ ] SKILL.md: Under 500 lines (put details in references/)
- [ ] Directory name matches
namefield exactly
Step 6: Create Files
mkdir -p ~/.claude/skills/{skill-name}
# Write SKILL.md using Write tool
Step 7: Verify
ls -la ~/.claude/skills/{skill-name}/
cat ~/.claude/skills/{skill-name}/SKILL.md
Test with: claude --debug to check for loading errors.
Naming Rules
| Rule | Valid | Invalid |
| -------------------------- | --------------- | ------------- |
| Lowercase only | my-skill | My-Skill |
| Hyphens OK | test-runner | test_runner |
| Numbers OK | v2-helper | - |
| No leading/trailing hyphen | skill | -skill- |
| No consecutive hyphens | my-skill | my--skill |
| 1-64 characters | a to 64 chars | empty or 65+ |
Best Practices
- Description is key: Claude uses it to decide when to invoke the skill
- Progressive disclosure: Keep SKILL.md light, put reference docs in
references/ - Always include examples: Shows expected input/output
- Scripts must be referenced: Mention them explicitly in SKILL.md
- Test immediately: Use
claude /your-skillto verify
Quick Mode
For rapid creation, user can provide all info at once:
/add-skill name=my-skill purpose="Does X" trigger="when user asks for Y"
Parse and generate without interactive prompts.
Resources
- Official docs: https://code.claude.com/docs/en/skills
- Anthropic skills repo: https://github.com/anthropics/skills
Related Skills
htlin222/zettel
testing
VerifiedTrustedCommunity
Converts narrative medical text into Pocket Medicine bullet-style notes with proper abbreviations, then modularizes sections exceeding 20 lines into linked standalone files.
76SKILL.mdUpdated Apr 5, 2026
htlin222/vm-docker
devops
VerifiedTrustedCommunity
Use when deploying Docker services on the local VM (hostname: vm, Pop!_OS) with Traefik reverse proxy and Homepage dashboard. Covers crane image workflow, Traefik file-provider registration, Homepage services.yaml entries, and compose templates on the traefik-proxy network.
76SKILL.mdUpdated Apr 5, 2026
htlin222/visualization-check
development
VerifiedTrustedCommunity
Use when reviewing a data visualization or figure for clarity, checking if a graph communicates its message without additional context, or iterating on R/Python plot scripts until a naive reader can fully understand the figure.
76SKILL.mdUpdated Apr 5, 2026
htlin222/vale
development
VerifiedTrustedCommunity
Runs Vale prose linter on markdown/text files and auto-fixes issues. Use when the user asks to lint, proofread, or improve writing quality of markdown or text files.
76SKILL.mdUpdated Apr 5, 2026