Agent skill
writing
Precision editing for prose and copy. Use when user says "edit this", "improve this", "review my writing", "use [name]'s voice", or provides draft text to refine. Triggers on editing, voice extraction, voice library, narrative structure, microcopy.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/writing-saadshahd-moo-md-acb7eb42
SKILL.md
Writing Skill
Router skill for writing and content workflows. Detects task type and routes to appropriate workflow.
When This Skill Activates
You're working on:
- Editing prose or documentation
- Extracting or matching author voice
- Managing saved voice profiles (list, apply, delete)
- Structuring narratives or stories
- Writing UI microcopy
- Evaluating content quality
Workflow Selection
Announce which workflow you're using:
| Task Type | Workflow | Reference |
|---|---|---|
| Analyze writing style, extract voice profile | Voice Extraction | references/voice.md |
| List, apply, or delete saved voices | Voice Library | /wordsmith:voices command |
| Edit text, cut fluff, tighten prose | Precision Editing | references/editing.md |
| Structure story, build narrative arc | Narrative Structure | references/narrative.md |
| Write UI copy, tone variations | Microcopy Tones | references/copy.md |
| Evaluate blog/content quality, score | Content Evaluation | references/eval.md |
| Create RFC, ADR, design doc, or blog | Document Template | ../template/SKILL.md |
Strategic Framework
| Framework | Purpose | When to Use |
|---|---|---|
| Open Loop | Make messages memorable via Zeigarnik effect | Copy, presentations, emails that need to stick |
Related Thinking Tools
From hope/skills/soul/references/tools/:
| Tool | When to Use |
|---|---|
| Minto Pyramid | Structure executive summaries, SCQA format |
| Productive Thinking | Multi-perspective content review |
Dimensions
This skill has multiple configuration dimensions. See compatibility-matrix.md for:
- Workflow x Voice Type
- Tone x Format (Microcopy)
- Editing Pass x Document Type
- Voice Dimension x Content Type
- Narrative Structure x Audience
Use ✓✓ combinations when possible; avoid ✗ combinations.
Usage
- Detect which workflow applies based on user's task
- Check compatibility matrix for dimension compatibility
- Announce: "I'm using the writing skill for [workflow]"
- Load the appropriate reference file
- Execute the workflow with confirmation gates (see below)
Confirmation Gates
Multi-step workflows pause at checkpoints to prevent wasted work when intent drifts.
Gate Points:
| Phase | Gate |
|---|---|
| After voice/style analysis | ⚠️ CHECKPOINT: "Does this capture the voice you want?" |
| After outline/structure | ⚠️ CHECKPOINT: "Here's my proposed structure. Should I proceed?" |
| Before final output | ⚠️ CHECKPOINT: "Ready to generate final version. Confirm?" |
Skip gates: Say "proceed without confirmation" to run uninterrupted.
In workflows: Each reference file should pause at these points:
### Phase 2: Analysis
[... phase content ...]
⚠️ **CHECKPOINT**: Present findings summary. Ask: "Does this capture the voice/style? Any adjustments before I continue?"
Rules
- Use Ask tool to gather input before proceeding
- Preserve author voice when editing
- Be specific about changes and rationale
- For evaluations, provide exact replacement text for fixes
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?