2
    codex-spec-interviewer

    codex-spec-interviewer

    by servrox

    Turn fuzzy requests into verified implementation specs and ADRs with source-backed architectural gating.

    Updated Jun 2026
    2 installs

    Free

    Included in download

    • Downloadable skill package
    • Works with Codex CLI, IDE extensions
    • 3 permissions declared
    • Instant install

    Sample input

    We need to update our auth to support JWT rotation. Check our security policy and existing middleware patterns, then prepare the spec and any necessary ADRs for the implementation.

    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

    Reviews

    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

    Terminal / Shell
    Browser
    Network Access

    File Scopes

    agents/**
    assets/**
    references/**

    Tags

    requirements-engineering
    adr
    documentation
    architecture
    planning
    codex

    Codex CLI, IDE extensions, Codex app, and agents supporting SKILL.md.

    Creator

    servrox

    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

    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.

    $1015 installs

    ai-automation-qa-pack

    Professional QA & UAT documentation generator for AI automation agencies and complex agent deployments.

    $59 installs

    Bounty Security Pattern Master Library — 399 Vulnerability Patterns

    A premium library of 399 vulnerability patterns and DeFi attack vectors for AI-driven bug hunting and security audits.

    $758 installs

    cinematic-sites

    Turn any basic business URL into a high-end cinematic landing page with AI-generated 4K assets and GSAP animations.

    $127 installs

    Free