Build with an AI agent¶

Give your AI coding agent the skills it needs to write a caution.hcl, build reproducible images, and debug enclave deployments.

Caution publishes a set of agent skills for Claude Code and Codex. Once installed, your agent knows how to package and debug an app for Caution and StageX without you having to paste in the docs.

Each skill is a SKILL.md — the format originated by Anthropic for Claude Code and now also read natively by Codex. Because the content is plain Markdown, it works with any agent: drop it into an AGENTS.md, CLAUDE.md, or your tool's equivalent if it doesn't support SKILL.md directly.

Skills¶

caution-platform¶

Write the Caution caution.hcl, and deploy or debug enclave apps locally and on AWS Nitro.

• caution.hcl authoring — unit command, container input, ports, resources, features
• Local QEMU debugging on a Linux host, or a Linux amd64 VM on macOS
• Attestation endpoint testing (/attestation request format, expected errors)
• Production health check failures, SSH debug mode, vsock and service logs

stagex-reproducible-builds¶

Reproducible, verifiable container images with StageX.

• Rust, Go, C/C++ build patterns with full vendoring
• Pallet selection and digest pinning
• SOURCE_DATE_EPOCH, RUN --network=none, hermetic builds
• The Containerfile; PCR reproducibility verification checklist

Install for Claude Code¶

for skill in caution-platform stagex-reproducible-builds; do
  mkdir -p ~/.claude/skills/$skill
  curl -sL https://codeberg.org/caution/agentic-skills/raw/branch/main/$skill/SKILL.md \
    -o ~/.claude/skills/$skill/SKILL.md
done

Install for Codex¶

Clone the repo, then copy the skill folders into ~/.codex/skills so Codex can discover both SKILL.md and agents/openai.yaml:

git clone https://codeberg.org/caution/agentic-skills.git
cd agentic-skills

for skill in caution-platform stagex-reproducible-builds; do
  mkdir -p ~/.codex/skills/$skill
  cp -R $skill/. ~/.codex/skills/$skill/
done

See also¶