
codex-spec-interviewer
by servrox
Turn fuzzy requests into verified implementation specs and ADRs with source-backed architectural gating.
- Convert vague feature ideas into testable technical specifications
- Automatically identify and document Architecture Decision Records (ADRs)
- Verify requirements against existing repository patterns and AGENTS.md rules
Free
One-time purchase
See it in action
A real example of what this skill takes in and produces.
Sample output
Artifacts saved: docs/specs/auth-refactor-spec.md, docs/adrs/0004-jwt-rotation.md
Summary: Verified JWT rotation strategy vs repo security policy.
Validation: Run npm test and scripts/verify-auth.sh.
Execution Prompt: "Use auth-refactor-spec.md to update the middleware..."
Turn fuzzy requests into verified implementation specs and ADRs with source-backed architectural gating.
Free
One-time purchase
Included in download
- Downloadable skill package
- 3 permissions declared
- Instant install
See it in action
A real example of what this skill takes in and produces.
Sample output
Artifacts saved: docs/specs/auth-refactor-spec.md, docs/adrs/0004-jwt-rotation.md
Summary: Verified JWT rotation strategy vs repo security policy.
Validation: Run npm test and scripts/verify-auth.sh.
Execution Prompt: "Use auth-refactor-spec.md to update the middleware..."
Screenshots
About This Skill
Stop Coding in the Dark
The Codex Spec Interviewer is a rigorous requirements-engineering skill for AI agents. It bridges the gap between a vague user request ("Add a billing dashboard") and a production-grade implementation plan that a coding agent can actually execute without hallucination or scope creep.
What it does
This skill engages in a "source-backed interview," scanning your repository's local AGENTS.md, existing ADRs, and codebase to challenge assumptions before a single line of code is written. It automatically gates architectural changes, ensuring significant decisions are captured as ADRs (Architecture Decision Records) rather than buried in chat history.
Supported Workflows
- Compact: Fast-track for low-risk, small feature edits.
- Standard: The default for bugfixes, refactors, and features.
- Deep: For complex, repo-wide migrations and architectural shifts.
Why use this skill?
Prompting an AI to "just write the code" often leads to technical debt and missed edge cases. This skill ensures your agent outputs a durable -spec.md file including testable acceptance criteria, validation commands, and rollout risks. It provides a dedicated 'Codex execution prompt'—a high-context handoff instructions specifically designed for coding agents to follow predictably.
Use Cases
- Convert vague feature ideas into testable technical specifications
- Automatically identify and document Architecture Decision Records (ADRs)
- Verify requirements against existing repository patterns and AGENTS.md rules
- Generate high-context execution prompts for coding agents to minimize errors
- Enforce repo-wide consistency for specs, validation plans, and rollout notes
How to Install
mkdir -p ~/.claude/skills && curl -sL https://www.agensi.io/api/install/codex-spec-interviewer | tar xz -C ~/.claude/skills/Free skills install directly. Paid skills require purchase - use the download button above after buying.
Reviews
No reviews yet - be the first to share your experience.
Only users who have downloaded or purchased this skill can leave a review.
No reviews yet - be the first to share your experience.
Only users who have downloaded or purchased this skill can leave a review.
Security Scanned
Passed automated security review
Permissions
File Scopes
Creator
Entrepreneur & Builder 🚀 Co-Founder and Managing Director at servrox solutions and stark AI
Frequently Asked Questions
Learn More About AI Agent Skills
More Premium Skills
handoff-writer
Generate high-density technical handoffs to resume work across agents or team members without losing context.
designing-hybrid-context-layers
Architects the right retrieval strategy for every query — teaching your agent when to use RAG, a knowledge graph, or a temporal index instead of defaulting to vector search for everything.
consumer-motivation-analyzer
Go beyond surface-level feedback to uncover the psychological drivers and hidden motivations behind buyer behavior.
keyword-research
Transform URLs or product lists into SEO keyword research packs with Google Ads data and intent-based clustering.