Refine Spec — Testing skill for Claude Code
Refine a spec by narrowing scope and splitting adjacent concerns (idea→draft).
How to install Refine Spec
Installs to ~/.claude/skills/bborbe-dark-factory-refine-spec/SKILL.md
mkdir -p ~/.claude/skills/bborbe-dark-factory-refine-spec && curl -fsSL https://raw.githubusercontent.com/bborbe/dark-factory/HEAD/commands/refine-spec.md -o ~/.claude/skills/bborbe-dark-factory-refine-spec/SKILL.md Restart Claude Code, or start a new session, for it to be picked up.
What Refine Spec does
description: Refine a spec by narrowing scope and splitting adjacent concerns (idea→draft) argument-hint: ""
Refine the dark-factory spec at $ARGUMENTS.
Resolve the path: if no prefix, look in `specs/` then `specs/ideas/`; append `.md` if missing.
Read the spec. If status is `approved`, `prompted`, `verifying`, or `completed` — refuse and tell the user to file a new spec for further changes.
Workflow
Run an interactive narrowing dialogue with the user. Use plain c
Alternatives in Testing
- Notion Spec To Implementation — Convert Notion specs into linked implementation plans and tasks 14.6k ★
- Crlf — Test for CRLF / HTTP response-splitting and host-header injection — Set-Cookie injection, cache poisoning, res 4.5k ★
- Claude Code Spec Workflow — Automated Kiro-style Spec workflow for Claude Code 3.6k ★
Full documentation available on GitHub
View Source RepositoryRelated Skills
Spec Design
Refine design.md for an active change. Surfaces missing constraints, writes the initial draft to disk, then re
Spec Requirements
Refine proposal.md and capability deltas for an active change. Interviews the user, writes the initial draft t
Unity Refine
Refines a raw GitHub issue into an implementation-ready spec — problem, acceptance criteria, scope, affected s
Spec Draft PR
Turn a feature idea or GitHub issue into a one-page spec saved to Documentation/specs/ and opened as a draft P
Vibe Cartographer
Plot your course from idea to shipped app — spec-driven development as a Claude Code plugin, delivered as 8 sl
Go Bigger
Think bigger about an idea, repo, or project: find the cost constraints that drew its scope, test which collap
Related Agents
Wd Architect
Use this agent when a feature idea, bug, or roadmap item needs to be turned into implementation-ready work-pac
Feature Spec
Turns a rough feature idea into a tight, buildable specification with scope, acceptance criteria, and an expli
Agent Idea Guide
The first step in your agent creation journey! This agent helps you discover, refine, and clearly define what