spec

Converts vague feature intent into reviewed, redacted GitHub issues with optional agent execution.

Updated Sep 13, 2026
One-click install
npx skills add https://github.com/abdulazeezoj/monovella-poc --skill spec-abdulazeezoj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/abdulazeezoj/monovella-poc/tree/main/.agents/skills/gstack/spec
Command: npx skills add https://github.com/abdulazeezoj/monovella-poc --skill spec-abdulazeezoj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a rough idea into an actionable engineering ticket usually means vague requirements, missing acceptance criteria, and accidental leakage of secrets or PII into public issues. This Skill runs a structured five-phase workflow that interrogates the intent, drafts a precise spec, quality-gates it with a second AI model, redacts sensitive content, and files it as a GitHub issue. ## Core Features & Use Cases - Structured spec drafting: Guides the user through decision briefs with recommendations, completeness scores, and tradeoff analysis to pin down scope and acceptance criteria. - Quality gate and redaction: Scores the draft 0-10 for executability via a codex review pass and runs fail-closed secret/PII scanning before anything is filed or archived. - Issue filing and agent spawn: Files the spec as a GitHub issue via gh, archives it locally with metadata frontmatter, and can spawn a Claude Code agent in a fresh git worktree to execute it. - Use Case: A developer says "spec this out" for a new billing retry feature; the Skill asks targeted scoping questions, drafts the ticket, redacts an internal customer name, files the issue, and spawns an agent to implement it in an isolated worktree. ## Quick Start Ask the assistant to spec out your feature idea and file it as a GitHub issue using the spec skill.

Frequently Asked Questions about spec

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

FAQPage Schema
How do I turn a feature idea into a GitHub issue with AI?

Invoke the spec skill with a phrase like "spec this out" or "make this a GitHub issue". It interviews you with structured decision briefs, drafts the spec, runs a quality gate, and files the issue via the gh CLI.

How does the spec quality gate work?

After you confirm the draft, the skill sends it to the codex CLI, which scores it 0-10 for executability by an unfamiliar implementer and lists ambiguities. Scores below 7 trigger revision rounds, with up to three dispatch attempts.

Does the spec skill prevent secrets from leaking into issues?

Yes. A fail-closed redaction scan covering roughly 30 secret, PII, and legal patterns runs on the exact bytes before filing, archiving, or codex dispatch. HIGH-severity findings block the operation entirely with no skip flag.

Can the spec skill execute the ticket after filing it?

Yes. With the --execute flag or in execution mode, it creates a pinned-SHA git worktree and spawns a Claude Code agent with the spec piped in. Dirty-worktree state triggers a confirmation gate with stash options first.

What happens if codex or gh is not installed?

The quality gate skips gracefully with an install notice when codex is missing, unauthenticated, or times out. If gh is unavailable, the skill prints the title and body for manual pasting into GitHub instead of filing.