Skills

Markdown knowledge packages that teach agents domain expertise. Like Claude Code skills, but for company agents. Based on the open agentskills.io standard.

What Are Skills

Skills are packaged knowledge documents with optional scripts and references that teach agents how to do specific things. Code review conventions, deployment checklists, API design patterns, incident response playbooks -- anything an agent needs to know is a skill.

Skill Format

skills/
├── code-review/
│   ├── SKILL.md              # Main knowledge document
│   ├── scripts/              # Optional automation scripts
│   ├── references/           # Optional reference materials
│   └── assets/               # Optional images, templates
├── deployment/
│   └── SKILL.md
└── git-workflow/
    └── SKILL.md

SKILL.md Frontmatter

---
name: code-review
description: |
  Code review standards, checklist, and conventions.
  Use when reviewing PRs or providing code feedback.
license: MIT
metadata:
  author: QUESTPIE
  version: 1.0.0
  tags: [code-quality, review, standards]
  roles: [reviewer, developer]
---

# Code Review

## When to Use
When reviewing pull requests or providing code feedback...

3-Stage Loading

Skills are loaded lazily to minimize context window usage:

1. Metadata -- on startup, the loader scans all skill directories and reads only the frontmatter
2. Body -- when an agent reads skills/{id}/SKILL.md, the full markdown body is loaded
3. Resources -- if the skill has a references/ directory, those files are listed and available on demand

Skill Templates

The Solo Dev Shop template ships with 20 customizable skill templates:

Creating Your Own Skill

1. Create the directory -- mkdir -p skills/my-skill
2. Write SKILL.md -- add frontmatter with name, description, and roles
3. (Optional) Add references -- put supporting docs in references/
4. (Optional) Add scripts -- put automation scripts in scripts/
5. Test it -- run autopilot skills to verify it appears in the catalog

CLI Commands

# List all available skills
$ autopilot skills

# Show a specific skill
$ autopilot skills show code-review

How Agents Use Skills

When an agent starts a session, it sees the list of available skills (filtered by role) in its context. When it needs domain knowledge, it reads the corresponding SKILL.md file and applies it.

// Agent calls:
read_file("skills/code-review/SKILL.md")

// → Full SKILL.md body injected into agent context
// → Agent follows the checklist and conventions

Marketplace (Future)

Community-created skills will be available via the QUESTPIE Marketplace:

$ autopilot marketplace install @community/skill-seo-expert
$ autopilot marketplace publish ./skills/seo-optimization