One-click install
npx skills add https://github.com/s0613/S-skills --skill sj-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sj-spec
Source: https://github.com/s0613/S-skills/tree/main/skills/sj-spec
Command: npx skills add https://github.com/s0613/S-skills --skill sj-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Vague, ambiguous product and feature requirements lead to team misalignment, implementation rework, and missed project goals. This Skill eliminates that friction by forcing clarity through structured, step-by-step questioning and validation, ensuring every spec is actionable before development starts.

Core Features & Use Cases

  • 5-Step Structured Spec Generation: Progresses through Why, Scope, Technical, Draft, and File stages to build complete, implementable specifications.
  • Forced Clarifying Questions: Uses a standardized set of 6 mandatory questions to eliminate ambiguity without unnecessary back-and-forth, making assumptions only when explicitly allowed.
  • Automatic Scope Triage: Identifies overly large scopes and proposes MVP vs full implementation options to keep projects on track.
  • Codebase Context Integration: Automatically explores existing project structure and interfaces to ensure specs align with current technical constraints.
  • Built-in Quality Validation: Runs a 7-point checklist on all drafts to verify specs are measurable, edge-case ready, and free of scope creep.
  • Downstream Dispatch Integration: Auto-registers generated spec paths to the project task file for seamless handoff to implementation agents. Use Case: If a stakeholder submits a vague request like "add a login feature", this Skill will generate a full, implementable spec with success metrics, scope boundaries, technical requirements, and acceptance criteria in minutes, no manual requirement gathering required.

Quick Start

Use the sj-spec skill to generate a full implementation-ready specification for the new user profile editing feature.

Frequently Asked Questions about sj-spec

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

FAQPage Schema
How do I turn vague product requirements into an actionable technical specification?

To turn vague product requirements into an actionable technical specification, use a structured 5-step generation process that asks forced clarifying questions to eliminate ambiguity, defines scope boundaries, and produces an implementable document with success metrics.

What is the best way to prevent scope creep when writing feature specifications?

The best way to prevent scope creep when writing feature specifications is through automatic scope triage that identifies overly large requests and explicitly proposes MVP versus full implementation options before drafting begins.

How do I generate a PRD that aligns with my existing codebase context?

To generate a PRD that aligns with your existing codebase context, use specification generation tools that automatically explore your current project structure and interfaces, ensuring technical requirements match existing constraints.

How to write feature specifications that include measurable acceptance criteria?

To write feature specifications with measurable acceptance criteria, apply a built-in quality validation checklist to your drafts, verifying that success metrics, edge cases, and scope boundaries are fully defined before implementation.

Does this specification generation process require manual requirement gathering for new features?

No, specification generation does not require manual requirement gathering for new features, as it uses a standardized set of mandatory questions to clarify assumptions automatically and outputs a complete, validated specification document.

How do I dispatch generated technical specifications to implementation agents?

To dispatch generated technical specifications to implementation agents, use downstream dispatch integration that auto-registers the generated spec file paths to your project task file for seamless workflow handoff.