spec-refiner

Refine vague requests into structured task briefs and handoff notes.

Updated Jan 8, 2026
One-click install
npx skills add https://github.com/lightningfastsls/London_Lab --skill spec-refiner-lightningfastsls
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-refiner
Source: https://github.com/lightningfastsls/London_Lab/tree/main/.codex/skills/spec-refiner
Command: npx skills add https://github.com/lightningfastsls/London_Lab --skill spec-refiner-lightningfastsls

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creates precise, verifiable task specs and consistent handoff notes from vague requests.

Core Features & Use Cases

  • Refines raw requests into structured task briefs with clear goals and acceptance criteria.
  • Generates a file-based handoff workflow in tasks/ including 00_task_brief.md and related notes.
  • Improves alignment between stakeholders and Implementers by enforcing a consistent documentation format.

Quick Start

Provide a raw task request and ask spec-refiner to generate a structured Task Brief and a handoff note following the tasks/ workflow.

Frequently Asked Questions about spec-refiner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn vague project requests into concrete task specs?

Vague project requests are refined into concrete, verifiable task specs by applying spec-refinement to generate a structured Task Brief with clear goals and acceptance criteria. This enforces consistent documentation format for project scoping.

What is the best way to create a handoff note for implementers in a tasks workflow?

Creating a handoff note for implementers in a tasks workflow is best handled by generating a file-based protocol that produces a structured 00_task_brief.md and related concise notes. This improves alignment between stakeholders and implementers.

How do I structure a task brief for project management?

Structuring a task brief for project management involves refining raw requests into a file-based workflow document at tasks/<date>_<slug>/00_task_brief.md. This produces verifiable specs and consistent handoff notes for implementers.

Can I use spec-refinement for official project handoffs?

Spec-refinement can be used for official project handoffs by applying it to product briefs and project scoping tasks. It produces a structured Task Brief and a concise handoff note following the file-based tasks/ workflow protocol.

Does generating a task brief require any specific dependencies?

Generating a task brief requires no specific dependencies or components. You provide a raw task request, and the spec-refiner generates the structured task brief and handoff note following the file-based tasks/ protocol.

When do I need a structured task brief instead of a raw request?

A structured task brief is needed when a raw request lacks clear goals and verifiable acceptance criteria. Refining it into a structured format ensures stakeholder alignment and provides consistent documentation for implementers.