Command Code

Best Practices for Skills

Follow these best practices to create effective and maintainable skills.

Writing effective descriptions

Good descriptions help Command Code know when to use a skill:

Specific and keyword-rich:

description: Extract text and tables from PDF files using pdfplumber. Use when user mentions PDFs, pdf files, document extraction, or needs to read PDF content.

Too vague:

description: PDF tools

Keep skills focused

Each skill should do one thing well:

Focused:

  • code-review - Code review checklist
  • commit-messages - Commit message format
  • testing-patterns - Testing conventions

Too broad:

  • development - All development tasks

Use progressive disclosure

Keep SKILL.md concise. Move detailed content to references/, for example:

# API Guidelines Quick reference of our API patterns. For complete documentation, see: - [Authentication details](references/AUTH.md) - [Error handling guide](references/ERRORS.md) - [Versioning strategy](references/VERSIONING.md)

Version control

Track your skills in Git:

Git tracking

# Add skills to git git add .commandcode/skills/ # Commit git commit -m "Add API guidelines skill" # Share with team git push

Don't ignore .commandcode/skills/ - these should be shared with your team.

Next steps