spec-setup

Install and verify the Codex-side SDD agent with hook trust and gate checks.

9|Updated May 27, 2026
One-click install
npx skills add https://github.com/kamioj/spec-workflow --skill spec-setup-kamioj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-setup
Source: https://github.com/kamioj/spec-workflow/tree/main/codex/skills/spec-setup
Command: npx skills add https://github.com/kamioj/spec-workflow --skill spec-setup-kamioj

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill ensures the proper installation and verification of the Codex-side SDD (Spec-Driven Development) agent, enabling users to trust hooks and verify that SDD gates are active after plugin installation.

Core Features & Use Cases

  • Agent Installation: Copies the necessary TOML files for the SDD agent from the plugin bundle to the Codex agent directory.
  • Hook Trusting Reminder: Reminds users to manually trust the SDD hooks in the Codex TUI.
  • Gate Verification: Verifies that the SDD gates are functioning correctly by attempting to execute a command that should be blocked by a gate.

Quick Start

Run the $spec-setup command after installing the sdd Codex plugin to ensure the setup is complete.

Frequently Asked Questions about spec-setup

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

FAQPage Schema
How do I verify SDD gates are active after installing the Codex plugin?

To verify SDD gates, run the spec-setup command after installing the sdd Codex plugin. It tests gate functionality by attempting to execute a command that should be blocked, confirming the gates are active.

What is the best way to install the SDD agent for spec-driven development in Codex?

The best way to install the SDD agent is by running the spec-setup command, which copies the necessary TOML files from the plugin bundle directly to the Codex agent directory to enable spec-driven development.

Do I need to manually trust hooks in the Codex TUI for spec-driven development?

Yes, you need to manually trust hooks in the Codex TUI for spec-driven development. The setup process copies the agent files and explicitly reminds users to complete this manual hook trusting step.

Why does my spec-driven development gate verification fail after plugin installation?

Gate verification fails if the SDD agent TOML files are not properly copied to the Codex agent directory or if the hooks have not been manually trusted in the Codex TUI after installation.

Can I use the Codex SDD agent setup without access to the plugin bundle?

No, you cannot use the Codex SDD agent setup without access to the plugin bundle. The setup requires the bundle to extract TOML files and the Codex TUI for hook management.

When do I need to run the spec-driven development agent setup in Codex?

You need to run the spec-driven development agent setup immediately after installing the sdd Codex plugin to ensure the SDD agent is properly installed, hooks are trusted, and gates are verified.