Skills and instruction discovery
The repository carries two Codex project skills:
.agents/skills/datasheet-to-constraints/SKILL.md.agents/skills/firmware-review/SKILL.md
Open the project root for repository discovery. AGENTS.md is root project guidance. Codex skill discovery is host-specific: project skills use .agents/skills; user-wide Codex skills use $HOME/.agents/skills (PowerShell: $env:USERPROFILE\.agents\skills). The Codex application may also expose installed plugin or legacy skill locations. Do not assume another assistant discovers these automatically: consult its current official instructions, then install a copy in that host's documented location. A frontmatter lint is not a behavioral test. Restart or open a fresh session after changes and check what the active tool actually discovers.
For explicit tests, request $datasheet-to-constraints or $firmware-review and give the exact project-relative path if discovery is uncertain. For automatic-trigger tests, use the ordinary requests below without naming the skill. Save the actual tool/model version, prompt, discovered instructions, response, command logs, diff and reviewer decision. These are test requests, not claimed results.
| Case | Fresh-session request | Observable acceptance |
|---|---|---|
| Datasheet relevant | Derive the Feather product 5477/BME280 interface constraints from the primary source links and sections in docs/hardware.md. | Table separates board from chip; every factual row is sourced; uncertainty is explicit |
| Datasheet unrelated | Correct spelling in this sentence only: “The teminal shows a reading.” | Ordinary prose edit, no forced hardware table |
| Datasheet incomplete | Map the pins for my ESP32-S3 board. I have not supplied its variant or schematic. | Does not guess; identifies the exact missing board reference |
| Review defect | Review the supplied bounded stale-policy fault diff in the fault checkpoint; do not fix it. | Finds the stale value/current problem tied to trigger/code; no bench claim |
| Review clean | Review a diff that only renames a local variable consistently without changing behavior. | No invented correctness finding; states actual checks |
| Review unrelated | Improve one README sentence without changing firmware. | Does the requested documentation task rather than forcing a firmware audit |
| AGENTS guidance | Make a bounded reporting-documentation edit in CP03, or add a test for one documented behavior in CP07 or later. | Reads applicable guidance, respects stage, runs the documented available commands, reports actual evidence |
| Handoff | Complete the fresh-session task in docs/handoff.md using only the repository. | Establishes real current state and produces a scoped change plus verifiable receipt |
For a minimal lint, run the Codex skill creator's quick_validate.py against each folder when that helper is available. Record it separately from the scenario results. These files are instruction text, not access control, sandbox configuration, or subagent definitions.