speckit-run-config

Recommends and writes council_members, workforce_depth, and lane values into a feature's profile.yaml with cost evidence.

Updated Jul 8, 2026
One-click install
npx skills add https://github.com/NarenKarthikBM/specseyal --skill speckit-run-config-narenkarthikbm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-run-config
Source: https://github.com/NarenKarthikBM/specseyal/tree/main/.claude/skills/speckit-run-config
Command: npx skills add https://github.com/NarenKarthikBM/specseyal --skill speckit-run-config-narenkarthikbm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After a feature spec is written, teams must decide how large the adversarial review council should be and how deep the task workforce should run, but they lack grounded cost data to make that call. This Skill automates that decision step: it computes a recommendation from the spec's own signals, backs it with exact session counts and measured token/time evidence, and writes the accepted configuration into the feature's profile.yaml. ## Core Features & Use Cases - Signal-based recommendation: Counts functional requirements, user stories, key entities, and cited contracts in spec.md to recommend council_members (1-8), workforce_depth (full|light), and lane (small|standard), each with a stated rationale. - Grounded cost evidence: Relays exact session counts and token/time figures verbatim from cost_evidence.py, distinguishing local repository history from foreign baseline data and never estimating unavailable numbers. - Safe profile writing: Never overwrites an existing profile.yaml, validates operator overrides against schema constraints, resolves lane composition, and runs interactively or automatically depending on context. - Use Case: After running /speckit-specify for a new feature, this hook fires automatically, presents a recommendation block with cost evidence, asks once for acceptance or override, and writes profile.yaml before the plan phase begins. ## Quick Start Run /speckit-run-config after specifying a feature to get a recommended council size and workforce depth with cost evidence written into the feature's profile.yaml.

Frequently Asked Questions about speckit-run-config

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

FAQPage Schema
How do I configure council size and workforce depth for a spec-kit feature?

Run /speckit-run-config after /speckit-specify, or let it fire automatically via the after_specify hook. It recommends council_members (1-8) and workforce_depth (full or light) from signals counted in spec.md, shows cost evidence, and writes your accepted values into the feature's profile.yaml.

How does the run-config recommendation get computed?

It counts functional requirements, user stories, key entities, and cited contracts in spec.md. Small features with few requirements get council_members 3, typical features get 5, and wide requirement surfaces get 8; workforce_depth light is recommended only for genuinely mechanical specs.

Does speckit-run-config overwrite an existing profile.yaml?

No. If profile.yaml already exists, it reads the file, reports the current council_members and workforce_depth values, and stops without modifying anything. This protects hand-authored profiles and earlier partial runs.

Can I run the run-config step non-interactively?

Yes. Pass --auto-config to the /speckit-specify invocation, or run in a context with no live operator, and the hook applies its recommendation automatically, reports what it did, and writes profile.yaml without prompting.

What dependencies does the run-config step require?

It requires .specify/feature.json and the feature's spec.md, plus the pipeline extension's cost_evidence.py and baseline.json (stdlib-only Python 3, no PyYAML). It optionally uses the workforce extension's validate-profile.py for a post-write self-check.