Claude Code and Codex skills
A reusable procedure
A skill packages instructions for a recurring job. Its description tells the assistant when to use it; the procedure explains what to do after selection. An original example is a review skill for a fictional subscription API: inspect the changed handler, test repeated requests and report whether the stored record changed twice.
Keep general repository facts in AGENTS.md or CLAUDE.md. A review procedure has a narrower trigger. Loading it for every unrelated task wastes context and can introduce conflicting instructions.
Files and trust
The Claude Code skills guide and Codex skills guide, checked November 14, 2026, describe a SKILL.md file with metadata, instructions and optional resources. Their discovery locations and invocation controls are product-specific; check the current guide before installing a skill.
Read supporting scripts before allowing them to run. A skill that asks to upload environment files or disable tests does not become safe because it has a helpful description. Practice the poisoned-skill case, then test the trigger against an unrelated request as well as a matching one.