speckit-guards

Validate Spec Kit workflow safety checks and token observability artifacts before protected actions.

Updated May 18, 2026
One-click install
npx skills add https://github.com/KamiJeong/tech-bridge-book --skill speckit-guards
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-guards
Source: https://github.com/KamiJeong/tech-bridge-book/tree/main/.agents/skills/speckit-guards
Command: npx skills add https://github.com/KamiJeong/tech-bridge-book --skill speckit-guards

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bash, git, jq, and includes scripts (resource) components.

What problem does it solve?

This Skill provides guardrails for Spec Kit and Codex workflow steps so protected actions only proceed when validation, safety checks, and repository conditions are acceptable.

Core Features & Use Cases

  • Pre-action safety checks: Verifies implementation, commit, and PR conditions before allowing workflow progress.
  • Read-only boundary protection: Confirms token analysis and guard phases do not modify product artifacts outside approved paths.
  • Token observability support: Records token steps and generates per-run reports, summaries, and quality notes for workflow tracking.
  • Agent definition validation: Checks .codex/agents/*.toml files for required fields, structure, and phase alignment.
  • Use Case: A teammate wants to auto-commit workflow changes, so the guards block the action until tests pass, secrets are absent, and token-analyzer availability is confirmed.

Quick Start

Ask the skill to validate your current Spec Kit workflow step and report whether the action is safe to continue.

Frequently Asked Questions about speckit-guards

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

FAQPage Schema
How do I add safety checks to prevent invalid commits in a Spec Kit workflow?

Spec Kit workflow safety checks validate implementation, commit, and pull request conditions before allowing protected actions to proceed. This blocks auto-commits until tests pass, secrets are absent, and repository conditions are acceptable.

What are pre-action workflow guards and when do I need them for Codex automation?

Pre-action guards for Codex automation validate safety conditions, token observability, and read-only boundaries before protected actions proceed. They are needed when automating implementation, commits, PR creation, and agent definition validation phases.

Do I need bash and jq installed to run Spec Kit validation scripts?

Yes, you need bash, git, and jq installed to run Spec Kit validation scripts. These dependencies are required for script execution, repository automation, and JSON validation of agent definitions and token observability artifacts.

How does token observability work in automated repository workflows?

Token observability in repository workflows records token steps and generates per-run reports, summaries, and quality notes for workflow tracking. It confirms token-analyzer availability and ensures read-only boundary protection for approved paths.

How do I validate Codex agent definition toml files for required fields and structure?

Validate Codex agent definition toml files by checking `.codex/agents/*.toml` files for required fields, structure, and phase alignment. Guard scripts verify these definitions conform to expected workflow requirements before protected actions proceed.

What happens if validation fails during a Spec Kit guard phase?

If validation fails during a Spec Kit guard phase, the protected action is blocked from proceeding. The guardrails prevent commits or PR creation until tests pass, secrets are absent, and all repository conditions are acceptable.