spec-author

Automate software specification creation and verification through multi-pass adversarial review.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/telefrek/jlsm --skill spec-author-telefrek
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-author
Source: https://github.com/telefrek/jlsm/tree/main/.claude/skills/spec-author
Command: npx skills add https://github.com/telefrek/jlsm --skill spec-author-telefrek

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires spec-resolve, work-context, spec-write, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the challenge of creating and validating detailed specifications for software features, ensuring they are robust, complete, and free of gaps or contradictions.

Core Features & Use Cases

  • Multi-pass Adversarial Review: Author specifications through a structured process, including drafting, falsification, and depth passes.
  • Feature-specific Authoring: Operates on design intent, focusing on what should be built rather than how it should be implemented.
  • Depth-pass-only Mode: Refine existing specifications with depth passes, focusing on specific lenses or domains.
  • Input Analysis: Utilizes feature briefs, domain analyses, and work plans to inform the specification process.
  • Pre-flight Checks: Includes revival detection, work group context, and layered-spec family loading for comprehensive authoring.
  • Adversarial Falsification: Uses knowledge bases and implementation grounding to identify potential gaps and contradictions.
  • Arbitration: Allows users to review findings and make decisions on how to address them.

Quick Start

Use the spec-author skill to create a new specification for a feature with the ID 'feature123' and title 'New Feature'.

Frequently Asked Questions about spec-author

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

FAQPage Schema
What is adversarial review for software specification writing?

Adversarial review for software specification writing is a multi-pass process that falsifies drafts against knowledge bases and implementation grounding to identify gaps and contradictions. It ensures feature designs are robust and complete before development begins.

How do I write and verify a feature design specification?

To write and verify a feature design specification, you use feature briefs, domain analyses, and work plans to draft the document. You then apply an adversarial review process to falsify findings and arbitrate corrections for completeness.

Can I refine an existing software specification without drafting from scratch?

Yes, you can refine an existing software specification using a depth-pass-only mode. This mode focuses on specific lenses or domains to add depth to your current document without requiring a full drafting cycle from scratch.

What inputs do I need to start authoring a software specification?

To start authoring a software specification, you need a feature brief, domain analyses, and a work plan. You also need a knowledge base for adversarial findings and implementation grounding to validate the design intent.

How does arbitration work when resolving specification contradictions?

Arbitration for specification contradictions allows you to review findings identified during adversarial falsification. You evaluate the detected gaps and make explicit decisions on how to address them within the feature design.