To create new CLI skills following Anthropic's official best practices with zero manual configuration. This skill automates brainstorming, template application, validation, and installation processes while maintaining progressive disclosure patterns and writing style standards.
Instrucciones de origen · Vista previa de solo lectura
name
skill-creator
description
To create new CLI skills following Anthropic's official best practices with zero manual configuration. This skill automates brainstorming, template application, validation, and installation processes while maintaining progressive disclosure patterns and writing style standards.
To create new CLI skills following Anthropic's official best practices with zero manual configuration. This skill automates brainstorming, template application, validation, and installation processes while maintaining progressive disclosure patterns and writing style standards.
When to Use This Skill
This skill should be used when:
User wants to extend CLI functionality with custom capabilities
User needs to create a skill following official standards
User wants to automate repetitive CLI tasks with a reusable skill
User needs to package domain knowledge into a skill format
User wants both local and global skill installation options
Core Capabilities
Interactive Brainstorming - Collaborative session to define skill purpose and scope
Prompt Enhancement - Optional integration with prompt-engineer skill for refinement
Template Application - Automatic file generation from standardized templates
Validation - YAML, content, and style checks against Anthropic standards
Installation - Local repository or global installation with symlinks
Progress Tracking - Visual gauge showing completion status at each step
Step 0: Discovery
Before starting skill creation, gather runtime information:
# Detect available platforms
COPILOT_INSTALLED=false
CLAUDE_INSTALLED=false
CODEX_INSTALLED=falseifcommand -v gh &>/dev/null && gh copilot --version &>/dev/null 2>&1; then
COPILOT_INSTALLED=truefiif [[ -d "$HOME/.claude" ]]; then
CLAUDE_INSTALLED=truefiif [[ -d "$HOME/.codex" ]]; then
CODEX_INSTALLED=truefi# Determine working directory
REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd)
SKILLS_REPO="$REPO_ROOT"# Check if in cli-ai-skills repositoryif [[ ! -d "$SKILLS_REPO/.github/skills" ]]; thenecho"⚠️ Not in cli-ai-skills repository. Creating standalone skill."
STANDALONE=truefi# Get user info from git config
AUTHOR=$(git config user.name || echo"Unknown")
EMAIL=$(git config user.email || echo"")
Key Information Needed:
Which platforms to target (Copilot, Claude, Codex, or all three)
Installation preference (local, global, or both)
Skill name and purpose
Skill type (general, code, documentation, analysis)
Main Workflow
Progress Tracking Guidelines
Throughout the workflow, display a visual progress bar before starting each phase to keep the user informed. The progress bar format is:
🎉 Skill created successfully!
📦 Skill Name: your-skill-name
📁 Location: .github/skills/your-skill-name/
🔗 Installed: Global (Copilot + Claude)
📋 Files Created:
✅ SKILL.md (1,847 words)
✅ README.md (423 words)
✅ references/ (empty, ready for extended docs)
✅ examples/ (empty, ready for code samples)
✅ scripts/ (empty, ready for utilities)
🚀 Next Steps:
1. Test the skill: Try trigger phrases in CLI
2. Add examples: Create working code samples in examples/
3. Extend docs: Add detailed guides to references/
4. Commit changes: git add .github/skills/your-skill-name && git commit
5. Share: Push to repository for team use
💡 Pro Tips:
- Keep SKILL.md under 2,000 words (currently: 1,847)
- Move detailed content to references/ folder
- Add executable scripts to scripts/ folder
- Update README.md with real usage examples
- Run validation before committing: scripts/validate-skill-yaml.sh
Error Handling
Platform Detection Issues
If platforms cannot be detected:
⚠️ Unable to detect GitHub Copilot CLI or Claude Code
Would you like to:
1. Install for repository only (works when in repo)
2. Specify platform manually
3. Skip installation
Template Not Found
If templates are missing:
❌ Error: Template not found at resources/templates/
This skill requires the cli-ai-skills repository structure.
Options:
1. Clone cli-ai-skills: git clone <repo-url>
2. Create minimal skill structure manually
3. Exit and set up templates first
Validation Failures
If content doesn't meet standards:
⚠️ Validation Issues Found:
1. YAML: Description not in third-person format
Expected: "This skill should be used when..."
Found: "Use this skill when..."
2. Content: Word count too high (5,342 words, max 5,000)
Suggestion: Move detailed sections to references/
Fix automatically? [Y/n]
Installation Conflicts
If symlink already exists:
⚠️ Skill already installed at ~/.copilot/skills/your-skill-name
Options:
1. Overwrite existing installation
2. Rename new skill
3. Skip installation
4. Install to different location
Bundled Resources
This skill includes additional resources in subdirectories:
references/
Detailed documentation loaded when needed:
anthropic-best-practices.md - Official Anthropic skill development guidelines
writing-style-guide.md - Writing standards and examples
