Agent skill

spec-viewer

Use when one feature must be inspected to determine inventory, readiness, earliest unresolved phase, routing recommendation, or drift signals.

View SKILL.md on GitHub Repository
Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/shaowei-g/codex-skills/tree/main/skills/spec-orchestrator/spec-viewer

SKILL.md

Spec Viewer

Use this skill when inspection is the current phase for one feature.

Shared Contracts

Load this shared shortcut first:

  • ../references/shared-specialist-contract.md

Open the deeper canonical shared references only when the shortcut is insufficient for the current situation.

Purpose

Use this skill when at least one is true:

  • artifact inventory, acceptance-marker inspection, or current feature-state inspection is needed
  • the earliest unresolved phase must be identified
  • phase readiness must be checked before delegation
  • one routing recommendation is needed for the next bounded pass
  • drift or stale-artifact signals must be identified from current artifacts or code

Read Order

  • repository-local workflow inspection prompt when available
  • specs/<feature>/handoff.md if present
  • specs/<feature>/spec.md if present and inspect front matter markers when present
  • specs/<feature>/plan.md if present and inspect front matter markers when present
  • specs/<feature>/tasks.md if present and inspect front matter markers when present
  • specs/<feature>/implementation-status.md if present
  • specs/<feature>/review.md if present
  • specs/<feature>/drift.md if present
  • changed code only when artifact state alone is insufficient

Owned Outputs

  • inspection summary in the shared schema
  • authoritative inspection verdict for current workflow state based on accepted markers when available
  • advisory next-phase recommendation based on accepted markers when available
  • minimal continuity notes only when the assigned scope explicitly asks for them

Phase-Specific Rejected Criteria

Return rejected if the request asks this skill to author phase-owned artifacts, implement work, or perform verification instead of inspection. Return rejected if the request tries to force a pre-decided route and treats inspection as confirmation-only instead of allowing a truthful current-state report.

Phase-Specific Blocked Criteria

Return blocked if the repository artifacts or code needed to determine current state are missing or unreadable.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

shaowei-g/codex-skills

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.

0 0
Explore
shaowei-g/codex-skills

ekoen-frontend-code-review

Production-grade code review for the eKoEN frontend codebase. Use when asked to review, audit, inspect, or harden eKoEN React/Next.js frontend code, pages, components, hooks, API clients, or state layers for bugs, performance bottlenecks, TypeScript safety issues, request inefficiency, state-management risks, memory leaks, rendering regressions, error-handling gaps, duplication, or maintainability problems, especially when a structured severity-ranked report with code locations, root causes, suggested fixes, and example refactors is required.

0 0
Explore
shaowei-g/codex-skills

ekoen-backend.doc.route-error

Add HttpErrorRes responses to eKoEN backend routes when controllers can throw errors from app/util/errors/index.ts

0 0
Explore
shaowei-g/codex-skills

conventional-commit-helper

Generate and validate Conventional Commit messages for semantic-release workflows. Use when a user asks to write a commit message, asks to commit changes, asks for commit type/scope selection, or asks to enforce Conventional Commits consistency.

0 0
Explore
shaowei-g/codex-skills

codex-cli-subagent-transport

Use only when native subagent execution is unavailable and the caller needs one deterministic Codex CLI run with repo-local artifacts and a manifest-based result contract.

0 0
Explore
shaowei-g/codex-skills

skill-usage-logger

All skill MUST use this logger to record usage events in NDJSON format.Log Codex skill usage events to NDJSON with safe concurrent appends.

0 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results