New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Requirement Convergence

by shinpr in shinpr/ai-coding-project-boilerplate

Separates the outcome a change must produce from the requirements proposed to reach it, records what the user excluded, and bands cost from structure.

MITAuto-check passed

Install Requirement Convergence

skills CLI
$ npx skills add shinpr/ai-coding-project-boilerplate --skill requirement-convergence -a claude-code

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

GitHub CLI
$ gh skill install shinpr/ai-coding-project-boilerplate requirement-convergence --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/shinpr/ai-coding-project-boilerplate.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills-en/requirement-convergence .claude/skills/requirement-convergence && 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
requirement-convergence
GitHub stars
233
Token cost
~1.2k tokens
SKILL.md length
618 words
Files
2 (incl. references)
Skills in repo
41
Repo updated
First seen
Licence
MIT

At a glance

Separates the outcome a change must produce from the requirements proposed to reach it, records what the user excluded, and bands cost from structure.

  • Works in 3 steps: Read the convergence record from the… → Treat nonGoals as excluded from the… → Treat a weak-but-explicit field as a…
  • A requirement enters a workflow
  • SKILL.md covers Purpose, Convergence Fields, Hearing Protocol and Storage Protocol, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Requirement Convergence is an agent skill from shinpr/ai-coding-project-boilerplate. Separates the outcome a change must produce from the requirements proposed to reach it, records what the user excluded, and bands cost from structure. Use when a requirement enters a workflow, before design begins, or when "how far do we go/what's out of scope/is this worth it" is mentioned.

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

The repository describes itself as: Agentic coding TypeScript boilerplate for Claude Code: sub-agent workflows with built-in quality checks and context engineering. The licence is MIT.

When your agent uses it

  • A requirement enters a workflow
  • Before design begins
  • How far do we go/whats out of scope/is this worth it is mentioned

Example prompts

  • “how far do we go/what”
  • “Use the requirement-convergence skill to separate the outcome a change must produce from the requirements proposed to reach it, records what the…”
  • “/requirement-convergence”

Workflow steps

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

  1. Read the convergence record from the prompt.
  2. Treat nonGoals as excluded from the current change and desired-future requirements as buildable scope. Evaluation requests, speculative…
  3. Treat a weak-but-explicit field as a recorded open question rather than a settled decision, and escalate when the work depends on…

What it can do on your machine

Read from SKILL.md and the folder at commit 56913a2. 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.

    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

Requirement Convergence loads about 1.2k tokens when it runs, and up to ~2.1k if it reads all its reference files. Until then it costs about 79 tokens; SKILL.md has 618 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~79
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.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

The full file from shinpr/ai-coding-project-boilerplate at commit 56913a2, republished under its MIT licence (© shinpr). 618 words, ~1,206 tokens.

Download SKILL.mdSave it as .claude/skills/requirement-convergence/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
requirement-convergence
description
Separates the outcome a change must produce from the requirements proposed to reach it, records what the user excluded, and bands cost from structure. Use when a requirement enters a workflow, before design begins, or when "how far do we go/what's out of scope/is this worth it" is mentioned.

Requirement Convergence

Purpose

Requirements arrive bloated, ambiguous, or aimed at the wrong outcome. A capable model reconciles all three into a coherent plan and builds it faithfully — delivering exactly what was asked for when what was asked for was wrong.

This skill converges what to build. How to build it, and which documents the change requires, are settled after the what is.

Convergence Fields

FieldPass condition
outcomeOne observable result. A requirement that does not serve it is excess.
requirements[]Every build-relevant item labeled current-state or desired-future.
nonGoals[]Authored by the user, or the user stated there are none.
costA band with the structural evidence that places it, plus the unknowns that remain.

cost is a rough band, not the effort estimate a work plan schedules against; requirements cannot support person-days. Its unknowns carry more decision weight than its size.

Classify from the user's own retained wording rather than an analyzer's restatement of it. Wording that asks for an evaluation, describes a speculative idea, or suggests a mechanism stays in active convergence context as a judgment-only candidate. requirements[] and durable documents receive a candidate only after explicit user confirmation.

Each field carries its own readiness label: ready, weak, or weak-but-explicit (weak, and the user agreed to leave it unresolved). Only the user sets weak-but-explicit. Requirements are converged when every applicable field is ready or weak-but-explicit.

Judgment rules per field: references/criteria.md.

Hearing Protocol

Use the available scope and cost evidence for both elicitation and judgment, then ask only for product choices that the repository cannot answer. Build requirements[] and the exclusion hearing from capabilities the user requested; an adjacent capability noticed during analysis stays out of both, so the user need not reject a capability they did not request. Repeat scope and cost analysis only when an answer changes the analysis target or required scope evidence.

Register these steps before starting and record each step's evidence as it completes:

StepActionCompletion evidence
1State the available scope facts, then separately what they imply for the requirementFacts listed with their analysis evidence
2Ask about the fields below ready, at most two questions per messageOne question per field below ready
3Record each answer as that field's valueThe value is the option the user explicitly selected or the wording the user supplied
4Re-ask once when a recorded value still fails its pass condition, then mark the field weak-but-explicit when the user agrees to leave the second answer as it standsTwo recorded answers, or the user's agreement to stop
5Judge each field against its pass condition and finalize the completed recordA convergence record with every field labeled
Show full SKILL.md (174 more words)Show less

Storage Protocol

CarrierHolds
The active convergence recordEvery field with its readiness label
PRD Success Criteria and Out of Scopeoutcome; user-authored nonGoals
Design Doc Requirement ConvergenceThe same when no PRD exists, and the fields left weak-but-explicit in every case

When neither document exists, retain the record in the active context.

Reference Protocol

  1. Read the convergence record from the prompt.
  2. Treat nonGoals as excluded from the current change and desired-future requirements as buildable scope. Evaluation requests, speculative ideas, prescribed mechanisms, and agent-proposed capabilities that were not promoted create no implementation obligation; an accepted ADR may retain evaluated options as decision history.
  3. Treat a weak-but-explicit field as a recorded open question rather than a settled decision, and escalate when the work depends on resolving it.

Quality Checklist

  • Scope facts were presented before questions were asked
  • nonGoals came from the user, or the user stated there are none
  • Every applicable field is ready, or weak-but-explicit by the user's agreement

References

  • references/criteria.md — judgment rules per field, cost inputs, challenge intensity, solution-in-disguise test

© shinpr, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in .claude/skills-en/requirement-convergence of shinpr/ai-coding-project-boilerplate.

  • SKILL.md
  • references/criteria.md

Open the folder on GitHubat commit 56913a2

Compare with similar skills

Requirement Convergence 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.

Requirement Convergence compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Requirement Convergence this skillshinpr/ai-coding-project-boilerplate233—~1.2kAutomated safety check: PassMIT
Requirement Convergenceshinpr/claude-code-workflows693—~1.5kAutomated safety check: PassMIT
Geo Proposalsickn33/agentic-awesome-skills47k1 repos~3.2kAutomated safety check: NotesMIT
Better Proposals AutomationComposioHQ/awesome-claude-skills77k3 repos~764Automated safety check: PassNone
Requirementsrizsotto/Bear6.5k—~2kAutomated safety check: PassGPL-3.0
Contract And Proposal Writeralirezarezvani/claude-skills28k2 repos~3.4kAutomated safety check: PassMIT

Similar skills

  • Requirement Convergence

    shinpr/claude-code-workflows

    Separates the outcome a change must produce from the requirements proposed to reach it, records what the user excluded, and bands cost from structure.

    693 GitHub stars~1.5k tokensUpdated 8 days ago
    Auto-check passed

  • Geo Proposal

    sickn33/agentic-awesome-skills

    Auto-generate a professional, client-ready GEO service proposal from audit data.

    47k GitHub starsUsed in 1 repo~3.2k tokens
    Sales & SupportAuto-check: notes

  • Better Proposals Automation

    ComposioHQ/awesome-claude-skills

    Automate Better Proposals tasks via Rube MCP (Composio). An agent skill from ComposioHQ/awesome-claude-skills.

    77k GitHub starsUsed in 3 repos~764 tokens
    Productivity & AutomationAuto-check passed

  • Requirements

    rizsotto/Bear

    Write, modify, or review a requirement file under docs/requirements -- pick the single owning file, keep the text contract-only, name IDs so they need no explanation, and verify cross-references and…

    6.5k GitHub stars~2k tokensUpdated yesterday
    Testing & QAAuto-check passed

  • Contract And Proposal Writer

    alirezarezvani/claude-skills

    Generate professional, jurisdiction-aware business documents: freelance contracts, project proposals, SOWs, NDAs, and MSAs.

    28k GitHub starsUsed in 2 repos~3.4k tokens
    Legal & ComplianceAuto-check passed

  • Proposal

    Chorus-AIDLC/Chorus

    Chorus Proposal workflow on Hermes — create proposals with document and task drafts, manage dependency DAG, validate, submit, and run the read-only proposal reviewer via delegatetask.

    1.2k GitHub stars~5.5k tokensUpdated today
    Sales & SupportAuto-check passed

More from shinpr/ai-coding-project-boilerplate

All 41 skills in this repo

  • Integration E2E Testing

    shinpr/ai-coding-project-boilerplate

    Selects and designs the smallest integration/E2E test set that proves accepted behavior at an observable boundary.

    233 GitHub stars~2.8k tokensUpdated 5 days ago
    Auto-check passed

  • Skill Optimization

    shinpr/ai-coding-project-boilerplate

    Evaluates and optimizes skill file quality using 9 content patterns and 10 editing principles.

    233 GitHub stars~3.5k tokensUpdated 5 days ago
    Auto-check passed

  • Frontend Technical Spec

    shinpr/ai-coding-project-boilerplate

    Defines React environment, component architecture, state/data flow, build verification, and frontend non-functional criteria from repository evidence.

    233 GitHub stars~1.9k tokensUpdated 5 days ago
    Auto-check: notes

  • Frontend Typescript Rules

    shinpr/ai-coding-project-boilerplate

    Applies React/TypeScript type safety, component design, and state management rules.

    233 GitHub stars~1.7k tokensUpdated 5 days ago
    Auto-check passed

  • Implementation Approach

    shinpr/ai-coding-project-boilerplate

    Selects implementation strategy (vertical slice, horizontal, or hybrid) with risk assessment.

    233 GitHub stars~3.2k tokensUpdated 5 days ago
    Auto-check passed

  • Subagents Orchestration Guide

    shinpr/ai-coding-project-boilerplate

    Coordinates subagents through scale-based planning, approval, implementation, verification, and escalation flows.

    233 GitHub stars~8k tokensUpdated 5 days ago
    Auto-check passed

Questions about Requirement Convergence

What does Requirement Convergence do?

Separates the outcome a change must produce from the requirements proposed to reach it, records what the user excluded, and bands cost from structure. Requirement Convergence is an agent skill from shinpr/ai-coding-project-boilerplate. Separates the outcome a change must produce from the requirements proposed to reach it, records what the user excluded, and bands cost from structure.

When should I use Requirement Convergence?

Requirement Convergence fits situations like: A requirement enters a workflow; before design begins; how far do we go/whats out of scope/is this worth it is mentioned.

How do I install Requirement Convergence in Claude Code?

Run `npx skills add shinpr/ai-coding-project-boilerplate --skill requirement-convergence -a claude-code`. Or copy the skill folder (.claude/skills-en/requirement-convergence in shinpr/ai-coding-project-boilerplate) into .claude/skills/requirement-convergence in your project. Claude Code loads it when a task matches its description.

How do I install Requirement Convergence in Codex?

Run `npx skills add shinpr/ai-coding-project-boilerplate --skill requirement-convergence -a codex`. Or copy the skill folder (.claude/skills-en/requirement-convergence in shinpr/ai-coding-project-boilerplate) into .agents/skills/requirement-convergence in your project. Codex loads it when a task matches its description.

Can I use Requirement Convergence 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 shinpr/ai-coding-project-boilerplate --skill requirement-convergence -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/requirement-convergence, .gemini/skills/requirement-convergence, .github/skills/requirement-convergence and .opencode/skills/requirement-convergence in your project.

What does Requirement Convergence need to run?

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

Does Requirement Convergence 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 Requirement Convergence 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 Requirement Convergence use?

Requirement Convergence is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Requirement Convergence use?

About 1.2k tokens (SKILL.md is roughly 4.8k 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 927 tokens, read only when the agent opens those files.

What are the alternatives to Requirement Convergence?

Skills that share tags, products or a category with Requirement Convergence: Requirement Convergence (shinpr/claude-code-workflows, 693 stars), Geo Proposal (sickn33/agentic-awesome-skills, 47k stars), Better Proposals Automation (ComposioHQ/awesome-claude-skills, 77k stars) and Requirements (rizsotto/Bear, 6.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Requirement Convergence?

shinpr (a GitHub user) maintains it in shinpr/ai-coding-project-boilerplate, which has 233 GitHub stars. The repository holds 41 skills in this directory. The repository was last updated on October 4, 2026.

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