Skip to main content

AI Agent Skills

Agent Skills provide structured, AI-readable documentation for your BurgerAPI project. They replace the legacy flat .llm-context files with a standard format that modern agentic IDEs discover automatically.

What Are Agent Skills?​

Agent Skills follow the agentskills.io open standard — a SKILL.md file with YAML frontmatter and progressive disclosure through reference documents.

Instead of attaching files manually, you install a skill once and your AI assistant finds it automatically.

How They Work​

  1. Install — burger-api skills install downloads the burger-api skill to .agents/skills/burger-api/
  2. Discover — Agentic IDEs scan .agents/skills/ at project root and load relevant skills
  3. Activate — When you ask about routing, middleware, or CLI tasks, the agent uses the skill as context

Installation​

With a New Project​

When you run burger-api create, you'll be asked:

◇  Add AI agent skills? (recommended for agentic IDEs)
│  Yes / No

Answer Yes (default) and the skill is installed automatically.

In an Existing Project​

burger-api skills install

This installs the default burger-api skill. You can also browse available skills:

burger-api skills available
burger-api skills list

Project Layout​

When skills are installed, your project includes:

.agents/
└── skills/
    └── burger-api/
        ├── SKILL.md
        └── references/
            ├── routing.md
            ├── validation.md
            ├── middleware.md
            ├── cli.md
            └── openapi.md

Compatible Agents​

No configuration needed — these tools discover .agents/skills/ automatically:

  • Cursor — loads skills as project context
  • Claude Code — reads from .agents/skills/
  • OpenCode — reads from .agents/skills/
  • OpenAI Codex — reads from .agents/skills/
  • GitHub Copilot — reads from .agents/skills/
  • Any tool supporting the agentskills.io standard

Migration from .llm-context​

If your project was created before CLI v0.9.9, it may have an ecosystem/.llm-context/ folder. To adopt the new format:

burger-api skills install

The skill at .agents/skills/burger-api/ provides the same context in a structured format. The old ecosystem/.llm-context/ folder can be safely removed.

Next Steps​