📝
AI EngineeringTypeScript

Generate Spec V2

by saffron-health

Generate Spec V2 is an AI Engineering skill for Claude Code, published by saffron-health in libretto.

877 stars67 forkson saffron-health/librettoAdded 2026/08/22Repository updated 2026/08/21
automationbrowserclaude-codecodexrpa
Install in seconds
Install Generate Spec V2
Copy Generate Spec V2 into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/saffron-health/libretto/tree/main/.agents/skills/generate-spec-v2 ~/.claude/skills/generate-spec-v2

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/saffron-health/libretto.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
.agents/skills/generate-spec-v2/SKILL.md in saffron-health/libretto
Installs to
~/.claude/skills/generate-spec-v2
Collection
One of 23 skills cataloged from this repository
Category
AI Engineering2451 skills

What Generate Spec V2 does

Generate Spec V2 creates a code-based implementation spec in specs/ for a feature, fix, or refactor. Use it when planning work that needs Mermaid flows, key types, phased diffs, and checks before implementation.

Generate Spec V2 is cataloged under AI Engineering on DirSkills. Generate Spec V2 comes from a repository tagged automation, browser, claude-code, codex and rpa.

Documentation

README

Generate an implementation spec

Write a spec in specs/ that an engineer can implement without repeating the research. Keep it lean, grounded in the current code, and focused on the requested result.

Research the change

  1. Read the request and repository instructions.
  2. Find the entry points, key types, state boundaries, callers, tests, and commands tied to the change. Trace each changed runtime path far enough to show an accurate diff.
  3. Read external docs only when a dependency or API affects the design. Prefer official docs and record the links used.
  4. Ask a question only when the answer would change the result and the code cannot answer it. Otherwise, make the narrowest sound assumption and record it.

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Generate Spec V2

  • What else does saffron-health publish alongside Generate Spec V2?

    Generate Spec V2 is one of 23 skills that DirSkills catalogs from saffron-health/libretto, the repository it ships in. Its siblings there include Address Review, CLI Development and Errore. Each one is a separate skill with its own page in this directory, installs the same way Generate Spec V2 does, and is maintained by saffron-health in that same repository. The rest of the collection is listed on the saffron-health/libretto page.

  • How does Generate Spec V2 compare to other AI Engineering skills?

    Generate Spec V2 ranks #1503 by stars among the 2451 AI Engineering skills in this catalog. The most-starred ones next to it are Architecture Decision Records, AI-First Engineering and Agentic OS. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Generate Spec V2 against them. Open each page to compare what they document and how they install.

More from saffron-health/libretto

Generate Spec V2 is one of 23 skills cataloged on DirSkills from saffron-health/libretto.

See all 23 skills
📝
1w ago

Address Review

Address Review systematically fetches PR feedback, applies requested code changes, and verifies them with tests and checks. Use it when responding to human review comments on a pull request.
Automation
87767
⌨️
1w ago

CLI Development

CLI Development designs command-line interfaces with scoped help, clear success messages, and diagnosable failures. Use it when creating or updating commands, argument parsing, exit codes, or human- and machine-friendly CLI output.
Automation
87767
⚠️
1w ago

Errore

Errore is Go-style error handling for TypeScript, where functions return Error | T instead of throwing. Use it when you want typed, visible error handling with early returns and cause chains.
AI Engineering
87767
🖥️
1w ago

External Electron Apps

External Electron Apps automates user-installed Electron desktop apps through Libretto and CDP. Use it to control apps like Slack, VS Code, Discord, Notion, Figma, or Spotify on the user's machine.
Automation
87767
🧩
1w ago

Fix Merge Conflicts

Fix Merge Conflicts resolves Git merge, rebase, and cherry-pick conflicts by checking PR intent and preserving compatible changes from both sides. Use it when unmerged paths or conflict markers need careful resolution before validation.
Automation
87767
📝
1w ago

Generate Spec

Generate Spec creates a spec sheet in the specs directory for a significant feature or complex fix. Use it to research the codebase, clarify open questions, and define goals, non-goals, and an implementation plan.
Writing
87767