1 files changed, 53 insertions, 0 deletions
diff --git a/skills/rust-bootstrap/SKILL.md b/skills/rust-bootstrap/SKILL.md
new file mode 100644
index 0000000..499bf04
--- /dev/null
+++ b/skills/rust-bootstrap/SKILL.md
@@ -0,0 +1,53 @@
+---
+name: rust-bootstrap
+description: Bootstrap or retrofit industrial-grade Rust linting by using the `rust_starter` repo as the source of truth. Use when Codex needs to set up strict Rust lint/check posture from scratch in a new repo, or ratchet an existing Rust repo toward manifest-owned lint policy without blindly overwriting valid local exceptions or stricter existing rules.
+---
+
+# Rust Bootstrap
+
+Read [AGENTS.md](/home/main/programming/projects/rust_starter/AGENTS.md) first.
+
+Then choose exactly one surface.
+
+## Fresh Bootstrap
+
+Use this when the target repo is blank or when you are setting up Rust linting from scratch.
+
+Read:
+
+- [docs/bootstrap-fresh.md](/home/main/programming/projects/rust_starter/docs/bootstrap-fresh.md)
+- [template/fresh](/home/main/programming/projects/rust_starter/template/fresh)
+
+Apply the template deliberately:
+
+- replace placeholder members, names, and version/toolchain values
+- keep repo-wide policy in root `Cargo.toml`
+- keep `clippy.toml` tiny or delete it
+- keep runners thin and orchestration-only
+
+## Retrofit
+
+Use this when the target repo already has Rust linting or check scripts and needs tightening.
+
+Read:
+
+- [docs/bootstrap-retrofit.md](/home/main/programming/projects/rust_starter/docs/bootstrap-retrofit.md)
+- [template/fresh](/home/main/programming/projects/rust_starter/template/fresh)
+- [docs/rust-linting-proposal.md](/home/main/programming/projects/rust_starter/docs/rust-linting-proposal.md)
+
+Retrofit is diff-aware ratchet work:
+
+- do not paste the fresh template wholesale
+- preserve stricter local policy
+- preserve justified local exceptions
+- move duplicated script or CI flags into manifest-owned policy
+- delete duplicate policy copies only after the manifest is authoritative
+
+## Guardrails
+
+- Re-open the repo docs when details matter; do not rely on memory.
+- Use [docs/rust-linting-proposal.md](/home/main/programming/projects/rust_starter/docs/rust-linting-proposal.md) for rationale, not as a paste target.
+- If a target repo already exceeds the template in some area, keep the stricter local posture.
+- If a target repo intentionally diverges, adapt the pattern instead of forcing uniformity.
+
+This skill is intentionally thin. The repo docs are the real payload.