Documentation Index
Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
Use this file to discover all available pages before exploring further.
Skills add domain expertise to an Agent. A Skill is a structured set of instructions and procedures that makes an Agent more capable and reliable on a specific kind of task.
What Skills Do
- Inject domain knowledge — give a generalist Agent specialized abilities (code review, document generation, etc.).
- Standardize procedures — ensure the Agent follows consistent steps and produces consistent output.
- Reusable — define once and share across multiple Agents.
Skill File Layout
A Skill is uploaded as a .zip archive containing:
my-skill/
├── SKILL.md # Required: Skill definition
├── templates/ # Optional: template files
│ └── report.md
└── examples/ # Optional: example files
└── sample.json
SKILL.md is the core file, written as YAML frontmatter plus Markdown:
name: code-review
description: Perform structured code reviews and produce improvement suggestions
version: 1.0.0
# Code Review
## Steps
1. Analyze the structure and architecture of the code.
2. Check for common issues (security, performance, maintainability).
3. Output a structured review report.
## Pitfalls
- Don't fixate on formatting — prioritize logic errors.
- Provide concrete fixes rather than vague critiques.
Create a Skill
POST https://openapi.qoder.sh/api/v1/cloud/skills
Content-Type: multipart/form-data
curl Example
# Package the skill directory
cd my-skill && zip -r ../my-skill.zip . && cd ..
# Upload
curl -X POST https://openapi.qoder.sh/api/v1/cloud/skills \
-H "Authorization: Bearer $QODER_PAT" \
-F "file=@my-skill.zip"
{
"id": "skl_abc123",
"name": "code-review",
"description": "Perform structured code reviews and produce improvement suggestions",
"version": "1.0.0",
"created_at": "2026-05-01T10:00:00Z"
}
Bind to an Agent
Use the Agent’s skills field to attach Skills:
curl -X PATCH https://openapi.qoder.sh/api/v1/cloud/agents/agt_abc123 \
-H "Authorization: Bearer $QODER_PAT" \
-H "Content-Type: application/json" \
-d '{
"skills": ["skl_abc123", "skl_def456"]
}'
Skill binding is currently gated behind the M2 milestone and requires opt-in.
Versioning
Re-uploading a skill with the same name creates a new version:
# Bump the version field in SKILL.md, then re-upload
curl -X POST https://openapi.qoder.sh/api/v1/cloud/skills \
-H "Authorization: Bearer $QODER_PAT" \
-F "file=@my-skill-v2.zip"
Get a Skill
curl https://openapi.qoder.sh/api/v1/cloud/skills/skl_abc123 \
-H "Authorization: Bearer $QODER_PAT"
List Skills
curl https://openapi.qoder.sh/api/v1/cloud/skills \
-H "Authorization: Bearer $QODER_PAT"
{
"data": [
{
"id": "skl_abc123",
"name": "code-review",
"version": "1.0.0",
"created_at": "2026-05-01T10:00:00Z"
},
{
"id": "skl_def456",
"name": "doc-generator",
"version": "2.1.0",
"created_at": "2026-04-20T08:30:00Z"
}
]
}
Delete a Skill
curl -X DELETE https://openapi.qoder.sh/api/v1/cloud/skills/skl_abc123 \
-H "Authorization: Bearer $QODER_PAT"
After deletion, Agents that reference the Skill will stop loading it on the next Session creation.
Authoring Tips
- State the trigger — write the
description so it’s clear when this Skill should be used.
- Be concrete in steps — describe precise actions, not vague guidance.
- Document pitfalls — help the Agent avoid common mistakes.
- Provide validation — tell the Agent how to confirm the task is complete.
FAQ
Q: How are Skills different from instructions? A: instructions is general guidance that applies to every task. A Skill is an on-demand expertise module the Agent activates based on the task at hand.
Q: How many Skills can an Agent reference? A: There’s no hard limit, but keep it under 10 to maintain predictable behavior.
Q: When will Skills go GA? A: The feature is in M2. Reach out if you want early access; broader rollout is coming in a later release.
Q: Is there a size limit on the zip? A: A single Skill zip must be 10 MB or less.
