BumpyClock/agent-templates / skills/productivity/writing-for-agents
writing-for-agents
UnverifiedCreate or revise agent instructions in skills, AGENTS.md, or CLAUDE.md.
Writing for Agents
Write instructions that change useful decisions. Do not prescribe a process for every task.
Checklist
- State the purpose, activation condition, and completion condition.
- Preserve user intent, project constraints, and authorization boundaries.
- Keep non-obvious rules that prevent a concrete failure.
- Remove generic reminders. Remove duplicate rules that another section or document already owns.
- Before adding a rule, name the decision it changes and one case where it does not apply.
- Revise the section that owns the decision. Do not append an overlapping exception.
- Put conditional procedures behind links. State when to read each link.
- Use project terms consistently. Keep valid domain vocabulary.
- Prefer observable outcomes over required artifacts, agent counts, or fixed sequences.
- Apply Concise wording to every edit. Cut words only where meaning stays exact.
Keep the root document small enough to show its decisions. A short, single-purpose document needs no extra files. Keep useful examples and scripts when replacing them would require repeated work.
Shared execution defaults
When changing shared execution defaults, pick the applicable cases below as acceptance criteria. Judge task outcomes, unnecessary work, authorization, and response usefulness. Do not judge prompt recitation or mechanical compliance. These cases define expected outcomes, not measured results.
| Task | Expected outcome |
|---|---|
| Small, isolated edit | Direct execution without unnecessary delegation |
| Independent, substantial tasks | Bounded delegation when its benefit exceeds coordination cost |
| Request for feedback | Analysis without file changes |
| Required tool unavailable | An alternative that preserves behavior and restrictions, or an explicit blocker |
| Behavior change | Relevant validation and documentation, subject to repository policy |
References
- For skill frontmatter and invocation choices, read Skill mechanics.
- For hard choices about disclosure, pointers, or document structure, read Instruction design.
After structural edits, validate links and metadata. Separate editorial judgment from measured model behavior.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 464k | Updated | Claude CodeCodex | Verified | Install |
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 464k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |