agents-md
AGENTS.md Creation & Refactoring
Create minimal, focused AGENTS.md files that use progressive disclosure.
Core Principles
- Instruction budget: LLMs can follow ~150-200 instructions consistently. Every token loads on every request.
- Progressive disclosure: Give agents only what they need now, point elsewhere for specifics.
- Avoid staleness: Don't document file paths—they change. Document capabilities and domain concepts.
What Belongs in Root AGENTS.md
Only these essentials:
- One-sentence project description (anchors agent decisions)
- Package manager (if not npm)
- Non-standard build/typecheck commands
Everything else goes elsewhere.
More from sebastiaanwouters/dotagents
flyctl
Deploy and manage apps on Fly.io using flyctl CLI. Triggers on: fly deploy, fly.io, flyctl, deploy to fly. Handles launch, deploy, scale, secrets, volumes, databases.
79teacher
Guide learning and deep understanding through proven methodologies (Socratic, Feynman, Problem-Based). Use when user says "help me understand", "teach me", "explain this", "learn about", "socratic", "feynman", "problem-based", "I don't understand", "confused about", "why does", or wants to truly grasp a concept.
77chef
Telegram communication for AI agents. ALL methods are BLOCKING. Use for user interviews, status updates, and feedback collection.
34librarian
Use for code research that needs dependency internals, upstream implementation examples, or external prior art. Always delegate to a subagent that investigates with opensrc and web search, then return only distilled findings, versions, paths, and links.
30bitwarden
Retrieves API keys, passwords, secrets from Bitwarden vault using bw CLI. Triggers on missing env variables, missing API keys, missing secrets, "secret not found", "env not set", or "use bw".
29frontend-design
Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications. Generates creative, polished code that avoids generic AI aesthetics.
28