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.

9 stars 3 forksAI, LLMs & Agents

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add sandbaseai/workbuddy-skill --skill agent-document-design
Manual install
git 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-design

Personal 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.
Read the full skill on GitHub

Details

Skill name
agent-document-design
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

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.