From blog-workflow
Refines blog post artifacts (spec, outline, draft) using review feedback or direct input, applies targeted improvements by type, removes review section, resets status to draft, and updates index.md.
How this command is triggered — by the user, by Claude, or both
Slash command
/blog-workflow:refine <path> ["feedback"]post/The summary Claude sees in its command listing — used to decide when to auto-load this command
# Post Refine Command
Update a post artifact (spec, outline, or draft) based on review feedback. Removes the `## Review` section after applying fixes and resets status to `draft` for re-review.
## Tools
- `Read` - Load artifact and review
- `Edit` - Apply changes
## Behavior
1. **Load artifact** at `{{path}}`
2. **Detect artifact type** from frontmatter
3. **Load feedback**:
- If `--feedback` provided, use that
- Otherwise, read `## Review` section from artifact
- If neither, error: "No feedback found. Provide --feedback or run review first."
4. **Load persona** (for voice ...Update a post artifact (spec, outline, or draft) based on review feedback. Removes the ## Review section after applying fixes and resets status to draft for re-review.
Read - Load artifact and reviewEdit - Apply changesLoad artifact at {{path}}
Detect artifact type from frontmatter
Load feedback:
--feedback provided, use that## Review section from artifactLoad persona (for voice consistency on drafts)
Apply improvements:
For post-spec:
For post-outline:
For draft:
Remove ## Review section
Reset status -> draft (for spec/outline)
Update updated timestamp
Self-review (fail items only):
Update index.md with status change
Refined: content/_drafts/kubernetes-migration-tutorial-basics.md
Changes applied:
- Added kernel version requirements to Prerequisites section
- Expanded edge case discussion in Step 3
- Adjusted Setup section (-50 words, was over estimate)
- Maintained practitioner voice throughout
Word count: {{new}} (was {{old}})
Status reset to: draft
Next: Run `/blog/post/review content/_drafts/kubernetes-migration-tutorial-basics.md`
| Condition | Error Message | Resolution |
|---|---|---|
| No feedback found | "No feedback found. Provide --feedback or run review first" | Run review or provide feedback |
| Artifact not found | "Artifact not found at {{path}}" | Verify path |
| Persona missing | "Cannot verify voice without persona '{{slug}}'" | Create or update persona reference |
# Refine based on review section
/blog/post/refine content/_projects/kubernetes-migration/post/tutorial-basics/spec.md
# Refine draft
/blog/post/refine content/_drafts/kubernetes-migration-tutorial-basics.md
# Refine with direct feedback
/blog/post/refine content/_drafts/kubernetes-migration-tutorial-basics.md --feedback "Make the introduction more engaging"
npx claudepluginhub arustydev/agents --plugin blog-workflow/retellTransforms a Claude Code conversation into a polished first-person blog post via interactive 5-stage pipeline (parse, triage, outline, draft, polish).
/refineEdits and sharpens existing product briefs or feature specs with new context. Accepts document path, ID, or interactive mode to select recent documents.
/refineRefines existing CLI harness for software at <software-path> by analyzing gaps in coverage and adding new commands/tests, optionally focusing on specific features.
/refineRefines existing cli-anything-web CLI: performs gap analysis, records new traffic, implements missing endpoints, updates tests and REPL help.
/refineLaunches a multi-agent refinement swarm on the current branch and PR — spawns a fixed team of reviewers against a branch diff, iterates on outcomes until resolved.
/refineRuns iterative refinement loop to improve project quality toward a goal, with max iterations, target condition, and semicolon-separated DoD criteria.