Agent Document Design
Use when creating or editing Skills, agent instruction files, or referenced documents so triggers, steps, disclosure, completion criteria, and maintenance remain predictable.
Install
npx skills add sandbaseai/workbuddy-skill --skill agent-document-designgit clone --depth 1 https://github.com/sandbaseai/workbuddy-skill.git /tmp/workbuddy-skill
mkdir -p ~/.claude/skills
cp -r /tmp/workbuddy-skill/skills/agent-document-design ~/.claude/skills/agent-document-designPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Agent Document Design Use this Skill when an Agent-facing document is created, edited, split, linked, or retired. A good document causes the Agent to follow a predictable process on every relevant run; it does not merely produce the same output once. Design the trigger, information path, steps, references, and completion gate together. ## Design context pointers A context pointer is a reference that names material outside the current context and states when to load it. A Skill description and a line in an instruction file are both pointers. The wording controls invocation reliability, not just the target file. For each pointer: - put the leading trigger word first; - name the material's purpose and every genuinely distinct branch that should load it; - use one trigger per branch and remove synonym repetition; - avoid repeating identity already carried by the target; - ensure a required reference cannot be reached only through a vague pointer. Treat pointer text as an always-loaded context budget. Inline essential material when sharpening the pointer cannot make invocation reliable; disclose branch-specific detail when loading it on every run would distract or waste attention. ## Protect the information hierarchy Organize material by how immediately the Agent needs it: 1. **In-file steps**: ordered actions the Agent must perform now. 2. **In-file reference**: definitions or rules consulted while following those steps.
Details
- Skill name
agent-document-design- Repository
- sandbaseai/workbuddy-skill
- Path
skills/agent-document-design/SKILL.md- License
- MIT
- Repo updated
- 8 September 2026
FAQ
What does the Agent Document Design skill do?
Use when creating or editing Skills, agent instruction files, or referenced documents so triggers, steps, disclosure, completion criteria, and maintenance remain predictable.
How do I install the Agent Document Design skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add sandbaseai/workbuddy-skill --skill agent-document-design. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Agent Document Design popular?
It lives in sandbaseai/workbuddy-skill, which has 9 GitHub stars and 3 forks.
Related skills
Access Control Security Best Practices
9sandbaseai/workbuddy-skill
Design, review, implement, and verify least-privilege access controls across users, services, tenants, resources, and administrative workflows.
Accessibility Review
9sandbaseai/workbuddy-skill
Use when reviewing a web interface or interaction for semantic, keyboard, focus, screen-reader, ARIA, and contrast accessibility risks.
Acquire Codebase Knowledge
9sandbaseai/workbuddy-skill
Use when the user asks to map, document, or onboard into an existing codebase and needs evidence-backed architecture, structure, conventions, integrations, testing, and concerns documentation.
Agent Evaluation Engineering
9sandbaseai/workbuddy-skill
Design reproducible evaluations for agent capabilities, trust, safety, trajectories, regressions, latency, and cost.
Agent Discoverability
9sandbaseai/workbuddy-skill
Use when publishing or auditing an MCP or agent endpoint so third-party agents can find it, understand its capabilities, and complete its authorized authentication flow.
Agent Governance
9sandbaseai/workbuddy-skill
Use when governing an Agent that can call tools or delegate work, including policy-based allowlists, intent risk checks, approval gates, rate limits, trust scoring, content controls, and audit trails.
Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.