Agent skill

Spec First Mvp

by cnfjlhj in cnfjlhj/ai-collab-playbook

A skill your agent uses when one idea feels exciting enough that the user may rush into implementation before the scope is stable.

No licenceAuto-check passedDevelopment

Install Spec First Mvp

skills CLI
$ npx skills add cnfjlhj/ai-collab-playbook --skill spec-first-mvp -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install cnfjlhj/ai-collab-playbook spec-first-mvp --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/cnfjlhj/ai-collab-playbook.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/full/spec-first-mvp .claude/skills/spec-first-mvp && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
spec-first-mvp
GitHub stars
454
Token cost
~871 tokens
SKILL.md length
412 words
Files
2 (incl. references)
Skills in repo
17
Repo updated
First seen
Licence
None found

At a glance

A skill your agent uses when one idea feels exciting enough that the user may rush into implementation before the scope is stable.

  • Works in 6 steps: Triage the raw idea. → Write a spec seed. → Define 1-3 throwaway MVP probes. → …
  • One idea feels exciting enough that the user may rush into implementation before the scope is stable
  • SKILL.md covers Overview, Rules, When to Use and Workflow, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Spec First Mvp is an agent skill from cnfjlhj/ai-collab-playbook. Use when one idea feels exciting enough that the user may rush into implementation before the scope is stable. Turn the idea into a spec seed, define 1-3 throwaway MVP probes, and set a go/no-go gate before full design or execution.

Its SKILL.md is about 870 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/spec-seed-template.md`).

It sits in Development, covering Spec-driven development and Feature launches and release readiness. The repository describes itself as: Practical AI collaboration playbook for research, writing, reading, and coding: article, prompts, agent rules, and reusable skills.

When your agent uses it

  • One idea feels exciting enough that the user may rush into implementation before the scope is stable
  • Tasks that involve Spec-driven development
  • Tasks that involve Feature launches and release readiness

Example prompts

  • “/spec-first-mvp”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Triage the raw idea.
  2. Write a spec seed.
  3. Define 1-3 throwaway MVP probes.
  4. Recommend one first probe.
  5. Set the go/no-go gate.
  6. Route forward.

What it can do on your machine

Read from SKILL.md and the folder at commit b3ee0d6. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Spec First Mvp loads about 871 tokens when it runs, and up to ~1.1k if it reads all its reference files. Until then it costs about 62 tokens; SKILL.md has 412 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~62
When it runs · the whole SKILL.md, loaded when a task matches
~871
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 412 words (~871 tokens).

“Use this skill when the danger is not lack of ideas, but too much momentum too early.”

— opening of SKILL.md by cnfjlhj
name
spec-first-mvp

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (references) in skills/full/spec-first-mvp of cnfjlhj/ai-collab-playbook.

  • SKILL.md
  • references/spec-seed-template.md

Open the folder on GitHubat commit b3ee0d6

Compare with similar skills

Spec First Mvp next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Spec First Mvp compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Spec First Mvp this skillcnfjlhj/ai-collab-playbook454—~871Automated safety check: PassNone
Herdr Pre-Release Auditherdrdev/herdr43k—~289Automated safety check: PassApache-2.0
Happier Reviewhappier-dev/happier1.9k—~4.5kAutomated safety check: PassMIT
Ss SpecSerial-Studio/Serial-Studio7.2k—~766Automated safety check: PassCustom licence
BiSheng SDD Document Reviewdataelement/bisheng12k—~717Automated safety check: PassApache-2.0
Megaphone ReleaseKuberwastaken/megaphone170—~1.3kAutomated safety check: PassMIT

Similar skills

  • Audit herdr release readiness by comparing commits since the base release against next-release changelog and docs. Use when asked to run or apply the repo's…

    43k GitHub stars~289 tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Happier Review

    happier-dev/happier

    Conduct evidence-backed Happier code, plan-completeness, session, worktree, feature, commit, branch, PR, codebase, and release-readiness reviews with affected-corridor analysis, high-confidence…

    1.9k GitHub stars~4.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Ss Spec

    Serial-Studio/Serial-Studio

    Phase 1 of Serial Studio's spec-driven workflow: capture WHAT a feature must do and WHY, with no implementation detail.

    7.2k GitHub stars~766 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • BiSheng SDD Document Review

    dataelement/bisheng

    Reviews BiSheng spec, design and tasks documents with checklists for PRD gaps, handover readiness and acceptance traceability, producing a report or an LGTM.

    12k GitHub stars~717 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Megaphone Release

    Kuberwastaken/megaphone

    Prepare, validate, publish, and verify Megaphone releases. An agent skill from Kuberwastaken/megaphone.

    170 GitHub stars~1.3k tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Create Release Checklist

    software-mansion/smelter

    Generate a GitHub release-checklist issue for a full (non-RC) release of the Smelter server and/or the TypeScript SDK.

    734 GitHub stars~1.9k tokensUpdated yesterday
    DevelopmentAuto-check: notes

More from cnfjlhj/ai-collab-playbook

All 17 skills in this repo
  • Paper2html

    cnfjlhj/ai-collab-playbook

    A skill your agent uses when turning an academic paper PDF/arXiv/OpenReview page/local LaTeX source into a single-file Chinese HTML deep-reading page, especially when the user wants a Cheat-Sheet…

    454 GitHub stars~2.4k tokensUpdated 26 days ago
    Auto-check passed
  • Xhs Longform Private Publisher

    cnfjlhj/ai-collab-playbook

    This skill should be used when the user wants to publish an existing Markdown article to Xiaohongshu as a private longform post, keep the original wording and structure, insert inline images in…

    454 GitHub stars~1.1k tokensUpdated 26 days ago
    Auto-check passed
  • Collaborating With Codex

    cnfjlhj/ai-collab-playbook

    A skill your agent uses when you explicitly want a second local or SSH remote Codex CLI session to prototype, debug, or review code, while your current session remains the primary owner of the final…

    454 GitHub stars~1.4k tokensUpdated 26 days ago
    Auto-check passed
  • Paperreview

    cnfjlhj/ai-collab-playbook

    A skill your agent uses when the user explicitly wants to upload a final or near-final PDF to paperreview.ai for an external second opinion.

    454 GitHub stars~668 tokensUpdated 26 days ago
    Auto-check passed
  • Research Lead Sidecar

    cnfjlhj/ai-collab-playbook

    A skill your agent uses when the user wants multi-agent division of labor for research-led work and the lead should stay on the critical path while 1-2 bounded sidecars handle low-coupling tasks.

    454 GitHub stars~842 tokensUpdated 26 days ago
    Auto-check passed
  • Xhs Note Creator

    cnfjlhj/ai-collab-playbook

    A skill your agent uses when the user wants Xiaohongshu note materials such as the note text, cover card, body cards, or publishing-ready assets.

    454 GitHub stars~638 tokensUpdated 26 days ago
    Auto-check: notes

Questions about Spec First Mvp

What does Spec First Mvp do?

A skill your agent uses when one idea feels exciting enough that the user may rush into implementation before the scope is stable. Spec First Mvp is an agent skill from cnfjlhj/ai-collab-playbook. Use when one idea feels exciting enough that the user may rush into implementation before the scope is stable.

When should I use Spec First Mvp?

Spec First Mvp fits situations like: one idea feels exciting enough that the user may rush into implementation before the scope is stable; tasks that involve Spec-driven development; tasks that involve Feature launches and release readiness.

How do I install Spec First Mvp in Claude Code?

Run `npx skills add cnfjlhj/ai-collab-playbook --skill spec-first-mvp -a claude-code`. Or copy the skill folder (skills/full/spec-first-mvp in cnfjlhj/ai-collab-playbook) into .claude/skills/spec-first-mvp in your project. Claude Code loads it when a task matches its description.

How do I install Spec First Mvp in Codex?

Run `npx skills add cnfjlhj/ai-collab-playbook --skill spec-first-mvp -a codex`. Or copy the skill folder (skills/full/spec-first-mvp in cnfjlhj/ai-collab-playbook) into .agents/skills/spec-first-mvp in your project. Codex loads it when a task matches its description.

Can I use Spec First Mvp in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add cnfjlhj/ai-collab-playbook --skill spec-first-mvp -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/spec-first-mvp, .gemini/skills/spec-first-mvp, .github/skills/spec-first-mvp and .opencode/skills/spec-first-mvp in your project.

What does Spec First Mvp need to run?

SKILL.md names no scripts, command-line tools or credentials: Spec First Mvp is instructions for the agent only.

Does Spec First Mvp access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Spec First Mvp safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Spec First Mvp use?

No licence was found for Spec First Mvp or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Spec First Mvp use?

About 871 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 233 tokens, read only when the agent opens those files.

What are the alternatives to Spec First Mvp?

Skills that share tags, products or a category with Spec First Mvp: Herdr Pre-Release Audit (herdrdev/herdr, 43k stars), Happier Review (happier-dev/happier, 1.9k stars), Ss Spec (Serial-Studio/Serial-Studio, 7.2k stars) and BiSheng SDD Document Review (dataelement/bisheng, 12k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Spec First Mvp?

cnfjlhj (a GitHub user) maintains it in cnfjlhj/ai-collab-playbook, which has 454 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on September 14, 2026.

Source: cnfjlhj/ai-collab-playbook on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.