skills.rest
DojoCodingLabs
DojoCodingLabsOFFICIAL
Explore all skills by this author →
Website𝕏@dojo_codingGitHub

spec-recommend

Process spec sources and SRD tasks into bilingual implementation briefs.

3|Updated Mar 30, 2026
Search Tags:#spec#OpenSpec#task-generation#agent-teams#gap-audit#implementation-brief#SRD
One-click install
npx skills add https://github.com/DojoCodingLabs/make-no-mistakes-toolkit --skill spec-recommend
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-recommend
Source: https://github.com/DojoCodingLabs/make-no-mistakes-toolkit/tree/main/skills/spec-recommend
Command: npx skills add https://github.com/DojoCodingLabs/make-no-mistakes-toolkit --skill spec-recommend

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reads spec files or SRD tasks and produces structured implementation briefs in the Bilingual Format (Human Layer + Agent Layer). Use when the user asks to "analyze this spec", "create an implementation brief", "process this SRD task", or wants to turn a spec document into actionable implementation steps. Supports OpenSpec, numbered steps, and SRD gap audit.

Core Features & Use Cases

  • Produces bilingual briefs that are readable by humans and executable by AI agents.
  • Supports two modes: Mode A (numbered steps) and Mode B (SRD + OpenSpec) with OpenSpec integration.
  • Handles SRD gap audits and maps tasks to OpenSpec changes and Linear issues for tracking.

Quick Start

Provide a spec document or SRD task, and the system will generate a bilingual implementation brief to the configured output path.

Frequently Asked Questions about spec-recommend

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

FAQPage Schema
How do I turn a spec document into an actionable implementation brief?▼

To turn a spec document into an implementation brief, process your spec sources or SRD tasks to generate structured actionable plans in a bilingual human and AI format. The system supports OpenSpec numbered-step specs and SRD gap audits.

What is a bilingual implementation brief for AI agents?▼

A bilingual implementation brief is a structured output containing a Human Layer for readability and an Agent Layer for AI execution. This format ensures generated spec tasks are directly executable by AI agent teams while remaining understandable to developers.

How do I process an SRD gap audit to map tasks for tracking?▼

Processing an SRD gap audit maps identified tasks directly to OpenSpec changes and Linear issues for project tracking. The system uses a linear-setup.json file for project mapping and outputs briefs to a configured directory.

Does spec-recommend work with OpenSpec and numbered-step specs?▼

Yes spec-recommend works with OpenSpec and numbered-step specs by operating in two distinct modes. Mode A handles numbered steps while Mode B supports SRD and OpenSpec integration to generate structured implementation briefs.

What is the best way to generate implementation steps from an SRD task?▼

The best way to generate implementation steps from an SRD task is to process the task using Mode B which integrates OpenSpec and maps gaps to Linear issues. This produces a structured bilingual brief for agent teams.

Do I need a linear-setup.json file to generate implementation briefs?▼

Yes you need a linear-setup.json file for project mapping when generating implementation briefs. The system relies on this configuration file to map tasks to OpenSpec changes and Linear issues before outputting briefs to the configured directory.

Related Skills

Explore More Software Engineering Skills→
jonalexjames84jonalexjames84
1

company-research

Document a company research brief covering fundamentals, product, strategy, and networking.

Community
Advanced
d0d012d0d012
9

linear-sync

Automate Linear issue, cycle, project, and team management with API interactions.

Community
Intermediate
AngelMaldonadoAngelMaldonado

cx-linear

Create, reference, and synchronize Linear issues from CX change documents.

Community
Intermediate
SensLiaoSensLiao

gsd-ns-ideate

Explore ideas, sketch designs, run technical spikes, and write specifications.

Community
Intermediate