| name | author-prompt-surface |
| description | Use when creating or editing .claude/agents/*.md, .claude/skills/*/SKILL.md, or .claude/commands/* — apply docs/prompting-standards.md (trigger conditions, model-agnostic bodies, no reasoning-as-text, effort floors). |
| user-invocable | false |
Author Prompt Surface
Claude-only discipline for the harness monorepo (and any plugin that ships
agents/skills). Load before writing or rewriting a prompt surface.
Required reading
Read and follow docs/prompting-standards.md in full. That document is the
source of truth; this skill is the invocation trigger + checklist.
Surfaces this skill covers
| Path | Role |
|---|
.claude/agents/*.md | Subagent prompts (model: frontmatter only for model pins) |
.claude/skills/*/SKILL.md | Skill prompts and stage workflows |
.claude/commands/* | Slash-command entrypoints |
Checklist (every new or edited prompt)
Copy from docs/prompting-standards.md — fail the edit if any box is open:
Model pins
- Pin models only in agent frontmatter (
model:) or the session model.
- Never name a model generation in the prompt body.
- One prompt body must run unchanged if the pin changes.
When not to use this skill
- Product application code under
src/ / generated apps.
- Disposable artifacts (mockups, ARB narratives, research) — use the lite lanes.
- Editing deterministic hooks/scripts — use code-gen + tests, not prompting standards.
After editing
If the change is a new control (gate, sensor, reviewer), also follow
HARNESS.md / harness-manifest.json registration so the control is not orphaned.
