Agent Skills

Command Code supports Agent Skills — a lightweight, open standard for extending AI agents with specialized knowledge and workflows.

What are Agent Skills?

Agent Skills are modular, self-contained instruction sets that teach Command Code how to perform specific tasks. Each skill is a folder containing a skill.md file with metadata and step-by-step guidance.

Think of skills as expert playbooks that Command Code can reference when needed. Instead of explaining the same process repeatedly, you define it once in a skill, and Command Code automatically applies it when needed.

How Command Code implements skills?

Command Code fully implements the Agent Skills open standard with two storage locations:

User-level skills (global)

Stored in ~/.commandcode/skills/ and available across all your projects.

Perfect for:

General development workflows
Exploratory workflows
Cross-project best practices

Project-level skills (local)

Stored in .commandcode/skills/ within your project and only available in that project.

Perfect for:

Project-specific patterns
Team conventions
Architecture guidelines
Domain-specific workflows

Note

Learn more about how to create user-level and project-level skills in the Create Skills docs.

Browse and use skills

Use the /skills slash command to view all the available skills:

Open skills menu

# In Command Code session
/skills

This shows:

All user-level skills with (user) label
All project-level skills with (project) label
Use arrow keys to navigate
Press Enter to open any skill in your editor
Press Esc to close and return to your session

Command Code automatically sees all your skills and uses them when relevant to the task.

How skills work

Skills use progressive disclosure to manage context efficiently:

Discovery: Command Code loads only name + description of each skill at startup (~100 tokens per skill)
Activation: When a task matches a skill, Command Code reads its full SKILL.md instructions.
Execution: Command Code follows the instructions, optionally loading referenced files as needed

This keeps Command Code fast while giving access to more context on demand.

Skills Specification

Every SKILL.md file should start with the frontmatter block followed by the markdown instructions in the body.

Frontmatter (required)

---
name: skill-name
description: A description of what this skill does and when to use it.
---

You can add the following optional fields to the frontmatter as needed:

---
name: pdf-processing
description: Extract text and tables from PDF files, fill forms, merge documents.
license: Apache-2.0
compatibility: Requires pdfplumber and PyPDF2 packages
metadata:
  author: example-org
  version: "1.0"
allowed-tools: Read Bash(python:*)
---

Field	Required	Constraints
`name`	Yes	Max 64 characters. Lowercase letters, numbers, and hyphens-separated only. Should not start or end with a hyphen.
`description`	Yes	Max 1024 characters. Describes what the skill does and when to use it.
`license`	No	License name or reference to a bundled license file.
`compatibility`	No	Max 500 characters. Describes environment requirements (packages, system tools, network access, etc.).
`metadata`	No	Arbitrary key-value mapping for additional metadata (author, version, etc.).
`allowed-tools`	No	Space-delimited list of pre-approved tools the skill may use. (Experimental)

Body content

The markdown body followed by the frontmatter contains the skill instructions. There are no format restrictions. Write whatever helps Command Code perform the task effectively.

Recommended sections:

When to use this skill: Clear triggers for activation
Step-by-step instructions: Detailed guidance
Examples: Input/output examples
Common edge cases: Known pitfalls and solutions

Note

Keep your main SKILL.md under 500 lines. Move detailed reference material to separate files in references/.

Optional directories

Your skill folder can also include these optional subdirectories to organize related files:

`scripts/`

Contains executable code that agents can run. Scripts should:

Be self-contained or clearly document dependencies
Include helpful error messages
Handle edge cases gracefully

my-skill/
├── SKILL.md
└── scripts/
    ├── extract.py
    └── process.sh

references/

Contains additional documentation that agents can read when needed:

my-skill/
├── SKILL.md
└── references/
    ├── API_REFERENCE.md
    ├── FORMS.md
    └── TROUBLESHOOTING.md

Keep individual reference files focused. Command Code loads these on demand, so smaller files mean less context usage.

assets/

Contains static resources:

my-skill/
├── SKILL.md
└── assets/
    ├── template.json
    ├── diagram.png
    └── schema.sql

Standard compliance

Command Code fully implements the Agent Skills open standard. Skills you create are:

Portable: Work with any agent that supports the standard
Versionable: Track changes with Git
Shareable: Publish for your team or community
Auditable: Plain text files anyone can read

Next steps

Manage your skills with the /skills command
Join our Discord community for support