writing-skills
Documentation & ProductivitéUse when creating, updating, or improving agent skills.
Documentation
Writing Skills (Excellence)
Dispatcher for skill creation excellence. Use the decision tree below to find the right template and standards.
⚡ Quick Decision Tree
What do you need to do?
📚 Component Index
| Component | Purpose |
|-----------|---------|
| [CSO](references/cso/README.md) | "SEO for LLMs". How to write descriptions that trigger. |
| [Standards](references/standards/README.md) | File naming, YAML frontmatter, directory structure. |
| [Anti-Rationalization](references/anti-rationalization/README.md)| How to write rules that agents won't ignore. |
| [Testing](references/testing/README.md) | How to ensure your skill actually works. |
🛠️ Templates
When to Use
How It Works
references/templates/Quick Example
---
name: my-technique
description: Use when [specific symptom occurs].
metadata:
category: technique
triggers: error-text, symptom, tool-name
---
# My Technique
## When to Use
- [Symptom A]
- [Error message]Common Mistakes
| Mistake | Fix |
|---------|-----|
| Description summarizes workflow | Use "Use when..." triggers only |
| No metadata.triggers | Add 3+ keywords |
| Generic name ("helper") | Use gerund (creating-skills) |
| Long monolithic SKILL.md | Split into references/ |
See [gotchas.md](gotchas.md) for more.
✅ Pre-Deploy Checklist
Before deploying any skill:
name field matches directory name exactlySKILL.md filename is ALL CAPSmetadata.triggers has 3+ keywordsreferences/ for more)@ force-loading in cross-references🔗 Related Skills
/write-skill command for guided skill creationExamples
Create a Tier 1 skill:
mkdir -p ~/.config/opencode/skills/my-technique
touch ~/.config/opencode/skills/my-technique/SKILL.mdCreate a Tier 2 skill:
mkdir -p ~/.config/opencode/skills/my-skill/references/core
touch ~/.config/opencode/skills/my-skill/{SKILL.md,gotchas.md}
touch ~/.config/opencode/skills/my-skill/references/core/README.mdCompétences similaires
Explorez d'autres agents de la catégorie Documentation & Productivité
agent-memory-systems
"Memory is the cornerstone of intelligent agents. Without it, every interaction starts from zero. This skill covers the architecture of agent memory: short-term (context window), long-term (vector stores), and the cognitive architectures that organize them. Key insight: Memory isn't just storage - it's retrieval. A million stored facts mean nothing if you can't find the right one. Chunking, embedding, and retrieval strategies determine whether your agent remembers or forgets. The field is fragm"
graphql-architect
Master modern GraphQL with federation, performance optimization,
go-concurrency-patterns
Master Go concurrency with goroutines, channels, sync primitives, and context. Use when building concurrent Go applications, implementing worker pools, or debugging race conditions.