Skip to content
Back to search

armory

Curated, production-grade skills for AI coding agents. Battle-tested workflows for developers who use AI seriously.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026. Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Mathews-Tom/armory with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Mathews-Tom/armory'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mathews-tom--armory/badge.svg)](/listings/mathews-tom--armory)

HTML

<a href="/listings/mathews-tom--armory"><img src="/api/listings/mathews-tom--armory/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Option 1 — Skills CLI (recommended)**

Install any package directly using [`npx skills`](https://github.com/vercel-labs/skills):

# Install all packages
npx skills add Mathews-Tom/armory

# Install a specific skill or agent
npx skills add Mathews-Tom/armory -s architecture-reviewer
npx skills add Mathews-Tom/armory -s codebase-advisor
npx skills add Mathews-Tom/armory -s codebase-auditor

# List available packages without installing
npx skills add Mathews-Tom/armory -l

**Option 2 — Profile installer**

git clone https://github.com/Mathews-Tom/armory.git
cd armory

# Install by profile
just install-profile core
just install-profile python-strict

# Install by type
uv run scripts/install.py --type skills
uv run scripts/install.py --type agents

# Interactive TUI
uv run scripts/install.py

Displays a version-aware table of all packages, detects installed versions, and lets you select which to install or upgrade. Profiles install curated bundles of packages across all types.

**Option 3 — Claude Code plugin marketplace (skills, agents, commands only)**

claude plugin marketplace add Mathews-Tom/armory
/plugin install armory

This uses Claude Code's native plugin system and loads a subset of armory's catalog.

| Package type | Supported via plugin marketplace | | ------------ | -------------------------------- | | skills | ✅ yes | | agents | ✅ yes | | commands | ✅ yes | | hooks | ❌ no — requires `npx skills` or the profile installer | | rules | ❌ no — armory-specific type, not a Claude Code plugin concept | | utilities | ❌ no — armory-specific type, not a Claude Code plugin concept | | presets | ❌ no — use `just install-profile` instead |

For the full catalog across all seven package types, use Option 1 (Skills CLI) or Option 2 (profile installer).

**Option 4 — Manual**

Clone the repo and symlink individual package folders:

git clone https://github.com/Mathews-Tom/armory.git

# Skills
ln -s "$(pwd)/armory/skills/architecture-reviewer" ~/.claude/skills/architecture-reviewer
ln -s "$(pwd)/armory/skills/codebase-advisor" ~/.claude/skills/codebase-advisor

# Agents
ln -s "$(pwd)/armory/agents/codebase-auditor" ~/.claude/agents/codebase-auditor

Or download `.skill` / `.agent` archives from the [Releases](../../releases) page.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 14 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "armory",
  3. "owner": {
  4. "name": "Mathews-Tom",
  5. "url": "https://github.com/Mathews-Tom"
  6. },
  7. "plugins": [
  8. {
  9. "name": "armory",
  10. "source": ".",
  11. "description": "Production-grade skills, agents, hooks, rules, and commands for Claude Code"
  12. }
  13. ]
  14. }
README.md · README · 676 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # armory
  2. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
  3. [![packages: 158](https://img.shields.io/badge/packages-158-informational)](manifest.yaml)
  4. [![evals: 100%](https://img.shields.io/badge/eval_coverage-100%25-success)](skills/)
  5. [![GitHub stars](https://img.shields.io/github/stars/Mathews-Tom/armory?style=social)](https://github.com/Mathews-Tom/armory/stargazers)
  6. [![catalog](https://img.shields.io/badge/catalog-browse_packages-58a6ff)](https://mathews-tom.github.io/armory/)
  7. Curated, production-grade skills, agents, hooks, rules, commands, utilities, and presets for AI coding agents. No magic, no demos — battle-tested workflows built for developers who use AI seriously.
  8. ---
  9. ## Overview
  10. `armory` is a collection of packages for [Claude Code](https://claude.ai/code) and Claude.ai. Each package is a self-contained prompt or automation unit that extends Claude with a repeatable, opinionated workflow for a specific task domain. Packages span seven types: skills, agents, hooks, rules, commands, utilities, and presets. An optional eighth type, native extensions, packages executable OMP and Claude Code modules that install only through an explicit per-host lifecycle.
  11. **Philosophy:** Packages in this collection are practical and context-free. They define the _how_, not just the _what_ — covering inputs, outputs, edge cases, and failure modes. They are tested in real workloads, not constructed as examples.
  12. Intended for developers who treat AI coding agents as a serious part of their workflow.
  13. ## Planning Lifecycle
  14. Use the planning packages in sequence, not as interchangeable formats:
  15. ```text
  16. unknown destination → decision-map → known design → plan-prompts → task-decomposer / plan-review → milestone-runner → stacked-prs
  17. ```
  18. | Situation | Package | Output |
  19. |---|---|---|
  20. | Destination or design is unresolved | [decision-map](skills/decision-map/) | Tracker-backed decision map, frontier, recorded decisions, and prototype evidence (built by [prototype](skills/prototype/)) when uncertainty needs executable evidence |
  21. | Design is known and needs milestones | [plan-prompts](skills/plan-prompts/) | Size-matched `DEVELOPMENT_PLAN.md` and `EXECUTION_PROMPTS.md` (or one prompt for one-PR work) with user-observable acceptance |
  22. | Feature is specified and needs implementation slices | [task-decomposer](skills/task-decomposer/) | Phased task board with dependencies and test matrix |
  23. | Existing plan needs a pre-implementation challenge | [plan-review](skills/plan-review/) | Severity-ranked plan review |
  24. | Approved plan needs execution across sessions | [milestone-runner](skills/milestone-runner/) | Goal-bound execution: one design check, observed outcome, CI, review and merge per milestone |
  25. `decision-map` stops at resolved decisions. It recommends `plan-prompts` after a complete map and never creates implementation milestones or tasks.
  26. Disposable prototypes are built by `prototype` and recorded as ticket evidence by `decision-map`; neither is a substitute for production implementation.
  27. Start with the shortest complete user workflow, not a tooling-only milestone. `plan-prompts` sizes the plan to the work, writes acceptance as `Done when <user> can <interaction> and sees <result>`, and moves unsourced checks to suggested follow-ups. `milestone-runner` restates each milestone's GOAL, NON-GOALS and DONE WHEN, does only the work acceptance requires, and treats a reviewed, green, merged milestone with an observed interaction as done.
  28. Both packages use the `3.0.0` contract; 2.x prompts still run. Missing release metadata blocks release preparation only. Static conformance and package/adapter checks do not establish live skill effectiveness.
  29. ---
  30. ## Package Catalog
  31. 158 package definitions across seven prompt/automation types and the optional native extension type. This is an unversioned rolling catalog; individual packages carry their own versions.
  32. ### Agents — Orchestrators
  33. Orchestrator agents compose skills and other agents into multi-phase workflows. Each can run solo or be spawned by another agent via the Agent tool.
  34. | Agent | Model | Description |
  35. | ------------------------------------------------ | ------ | --------------------------------------------------------------------------------------------------------------- |
  36. | [team-lead](agents/team-lead/) | opus | Meta-orchestrator — decomposes multi-domain requests, delegates to specialized agents, synthesizes results |
  37. | [codebase-auditor](agents/codebase-auditor/) | sonnet | Unified quality assessment — spawns code-reviewer, security-reviewer, secret-scanner in parallel, merges report |
  38. | [project-architect](agents/project-architect/) | opus | Phased requirements discovery producing architecture documents with diagrams and tech stack justification |
  39. | [project-planner](agents/project-planner/) | sonnet | Task decomposition with dependency mapping, three-point estimates, milestone timelines, and risk logs |
  40. | [research-analyst](agents/research-analyst/) | opus | Multi-source investigation with parallel agents across web, academic, video, and competitive sources |
  41. | [idea-scout](agents/idea-scout/) | opus | Business idea validation — Lean Canvas, parallel market/competitive/feasibility research, weighted scorecard |
  42. | [full-stack-builder](agents/full-stack-builder/) | opus | End-to-end implementation from spec — scaffolding, sprints, quality passes, documentation, pre-delivery review |
  43. | [release-captain](agents/release-captain/) | sonnet | Explicit release preparation — authorized version and changelog edits, quality gates, secret scan, release PR; stops at the PR |
  44. | [proposal-writer](agents/proposal-writer/) | opus | Technical proposals with ROI calculations, three-tier pricing, and Problem-Agitate-Solve framing |
  45. | [content-strategist](agents/content-strategist/) | sonnet | Multi-channel content creation with per-channel adaptation and automated quality passes |
  46. | [media-producer](agents/media-producer/) | sonnet | Visual and video format router — selects the right skill based on concept type and output needs |
  47. | [skill-librarian](agents/skill-librarian/) | sonnet | Explicit reflective capture — queues privacy-safe lessons, reports status, and reviews approved package changes |
  48. ### Agents — Analyzers
  49. | Agent | Model | Description |
  50. | ---------------------------------------------- | ------ | ----------------------------------------------------- |
  51. | [code-reviewer](agents/code-reviewer/) | sonnet | Multi-phase code review with severity-ranked findings |
  52. | [security-reviewer](agents/security-reviewer/) | sonnet | OWASP Top 10 vulnerability scanning |
  53. | [secret-scanner](agents/secret-scanner/) | haiku | Pre-commit detection of hardcoded credentials |
  54. | [skill-router](agents/skill-router/) | haiku | Outcome-weighted package routing using historical eval results |
  55. | [test-engineer](agents/test-engineer/) | sonnet | Co-evolutionary skill evolution with generate-verify-refine loops |
  56. > **Model routing:** Agents marked `opus` request Claude Code's `opus` alias with `xhigh` effort by default. The declared target matrix records the alias and an expected fully disclosed model-id prefix; a dated snapshot is an observed receipt field, never inferred from this declaration. Use `max` effort only for genuinely hard novel problems (diminishing returns, overthinking risk); use `high` for concurrent sessions or cost-sensitive work.
  57. ### Runtime model-fit target matrix
  58. `model_fit.yaml` declares the client/model/effort/profile/telemetry matrix. Its current target requests the Claude Code `opus` alias, requires a disclosed model ID beginning `claude-opus-`, and requires observed input-token and output-token fields.
  59. Validate a profile without creating a model request:
  60. ```bash
  61. uv run python scripts/model_fit.py --target claude-code-opus-xhigh --profile core --dry-run
  62. uv run python scripts/model_fit.py --target claude-code-opus-xhigh --profile full --dry-run
  63. ```
  64. Dry runs read `claude --version` and resolve repository package definitions only. They report discovery metadata and explicitly state that package content was not loaded. They do not install a profile or make a paid call.
  65. Use `--live --output /path/to/receipt.json` only when a model request is authorized. The probe disables built-in tools, suppresses ambient MCP configuration, and does not persist sessions. Its receipt stores derived fields only: declared target/profile/tool surface, client version, an observed model that must match the target's declared prefix, required token fields, wall time, and terminal metadata. Raw prompts, assistant text, and stream events are never retained. A missing or changed required field exits non-zero; the probe never estimates a token value.
  66. ### Skills — Development & Tooling
  67. | Skill | Description |
  68. | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
  69. | [agent-builder](skills/agent-builder/) | Build AI agents using the Claude Agent SDK and headless CLI mode — covers tool definitions, MCP servers, and programmatic orchestration |
  70. | [github](skills/github/) | GitHub CLI operations via `gh` — issues, PRs, CI/Actions, releases, search, REST/GraphQL API, with error handling and automation workflows |
  71. | [filesystem](skills/filesystem/) | File and directory operations via Claude Code built-in tools — replaces the Filesystem MCP server with native Read, Write, Edit, Glob, Grep |
  72. | [mcp-to-skill](skills/mcp-to-skill/) | Convert MCP servers into on-demand skills to reduce active context window token usage |
  73. | [gpu-optimizer](skills/gpu-optimizer/) | GPU optimization for consumer GPUs (8-24GB VRAM) — PyTorch, XGBoost, CuPy/RAPIDS, memory management, and CUDA tuning |
  74. | [tavily](skills/tavily/) | AI-optimized web search and content extraction via Tavily API with structured output parsing |
  75. | [test-harness](skills/test-harness/) | Comprehensive pytest suite generation — happy path, edge cases, error conditions, fixtures, mocks, async, parametrized tests |
  76. | [debug-investigator](skills/debug-investigator/) | Systematic debugging framework — hypothesis-driven investigation with bisection, log analysis, instrumentation, and minimal reproduction |
  77. | [project-context-setup](skills/project-context-setup/) | Scaffold repo-local agent context — issue tracker rules, triage labels, domain glossary layout, ADR lookup, agent brief conventions |
  78. | [domain-modeling](skills/domain-modeling/) | Challenge ambiguous domain terms, cardinalities, and code/model contradictions; capture agreed vocabulary without generic context scaffolding or ADR writing |
  79. | [walkthrough](skills/walkthrough/) | Deliver sourced, repeatable procedures for unavoidable human-only operations; keep agent-doable setup and repository onboarding with the agent |
  80. | [stacked-prs](skills/stacked-prs/) | Manage dependent branch stacks and stacked pull requests — inspect, split, publish, sync, validate, and record provenance; existing stacks land and clean up through ship-workflow |
  81. | [pr-explainer](skills/pr-explainer/) | Explain pushed PRs, whole stacks, or one stack member through source-grounded functional briefings and domain-knowledge updates; not defect review or merge approval |
  82. | [plan-prompts](skills/plan-prompts/) | Plan size-matched vertical increments from repository reality with user-observable acceptance; one prompt for one-PR work, unsourced checks as follow-ups |
  83. | [decision-map](skills/decision-map/) | Map unresolved architecture, policy, and scope decisions; record prototype-package evidence on decision tickets before implementation planning |
  84. | [prototype](skills/prototype/) | Answer one design question with a throwaway, scratch-only artifact — a shareable state demo or switchable UI variants — observed in a browser before any verdict |
  85. | [milestone-runner](skills/milestone-runner/) | Run milestones toward the plan's goal with one design check, observed outcome, CI, review and merge; resume from merged-PR evidence |
  86. | [to-markdown](skills/to-markdown/) | Convert any file or URL to clean Markdown via MarkItDown — PDF, DOCX, XLSX, PPTX, HTML, images, audio, CSV, JSON, XML, YouTube, EPub |
  87. | [web-fetch](skills/web-fetch/) | Web content fetching via curl and WebFetch — replaces the Fetch MCP server with native HTTP operations and jq parsing |
  88. | [lightpanda-browser](skills/lightpanda-browser/) | Lightweight headless browser automation via Lightpanda + agent-browser CDP — 9x lower memory, 11x faster, for scraping, DOM extraction, and form automation |
  89. | [skill-library](skills/skill-library/) | Agent-native catalog for browsing, installing, updating, syncing, and removing armory skills from within a Claude Code session |
  90. | [skill-inventory](skills/skill-inventory/) | Locate or checksum-verify install the skill-inventory utility, then hand off to its operator guide for skill exposure and read audits |
  91. | [env-validator](skills/env-validator/) | Validate `.env` files against project requirements — missing vars, type mismatches, insecure defaults, `.env.example` drift |
  92. | [handoff](skills/handoff/) | Maintain `.docs/handoff.md` as a 200-line session-continuity runbook for in-flight work, blockers, decisions, validation state, and resume steps |
  93. ### Skills — Research & Analysis
  94. | Skill | Description |
  95. | ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  96. | [literature-review](skills/literature-review/) | Systematic literature review — search, screen, extract, and synthesize academic research with gap analysis and structured citations |
  97. | [youtube-search](skills/youtube-search/) | Search YouTube by keyword via yt-dlp — returns structured metadata (title, URL, channel, views, duration, date) for discovery and source curation |
  98. | [watch](skills/watch/) | Local video analysis from timestamped captions, bounded frames, and explicitly provisioned speech transcription — concepts, visual evidence, takeaways, and source-linked notes |
  99. | [notebooklm](skills/notebooklm/) | Google NotebookLM automation via notebooklm-py — create notebooks, add sources, chat, generate podcasts, videos, infographics, quizzes, flashcards, and more |
  100. | [research-critique](skills/research-critique/) | Critical analysis of research papers — methodology evaluation, claims-evidence alignment, contribution assessment with collegial analytical posture |
  101. | [immune](skills/immune/) | Hybrid adaptive memory with Cheatsheet (positive patterns) and Immune (negative patterns) — Hot/Cold tiered memory, multi-domain antibody scanning, auto-learning |
  102. | [learning-workspace](skills/learning-workspace/) | Persistent human learning with user-owned mission, lessons, practice evidence, and misconception history across sessions; not one-off repo tutoring or agent memory |
  103. ### Skills — Review & Quality
  104. | Skill | Description |
  105. | ------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- |
  106. | [appraise](skills/appraise/) | Evidence-based competency and seniority appraisal from one or more Git repositories — blame-verified attribution, fork/upstream separation, rubric-driven levels with uncertainty, development plan, targeted questions |
  107. | [architecture-reviewer](skills/architecture-reviewer/) | Architecture reviews across 7 scored dimensions — structural integrity, scalability, security, performance, enterprise readiness, operations, data |
  108. | [codebase-advisor](skills/codebase-advisor/) | Senior repo advisor — audits codebase evidence, vets findings, and writes self-contained implementation plans for executor agents |
  109. | [code-refiner](skills/code-refiner/) | Deep code simplification and refactoring — structural complexity analysis, anti-pattern detection, idiomatic rewrites across Python, Go, TS, Rust |
  110. | [module-deepening](skills/module-deepening/) | Find shallow modules worth deepening (offline HTML report) or design one module's interface several ways; one question at a time, stops at a decision, never edits code |
  111. | [citation-audit](skills/citation-audit/) | Citation verification for manuscripts — checks that references are real, correctly attributed, and accurately described |
  112. | [figure-rhetoric](skills/figure-rhetoric/) | Figure and plot communication audit — evaluates whether visuals support the claims they are meant to carry |
  113. | [figure-table-quality](skills/figure-table-quality/) | Figure and table rendering audit — checks readability, label collisions, accessibility, formatting, and consistency |
  114. | [pr-review](skills/pr-review/) | Diff-based PR review across 5 dimensions — code quality, test coverage, silent failures, type design, comment quality with severity-ranked output |
  115. | [pre-landing-review](skills/pre-landing-review/) | Gate-oriented safety audit with two-pass severity triage — CRITICAL (SQL, races, trust) blocks landing, INFORMATIONAL is advisory |
  116. | [plan-review](skills/plan-review/) | Pre-implementation plan audit stress-testing scope, assumptions, risks, and failure modes with product and engineering lenses |
  117. | [manuscript-review](skills/manuscript-review/) | Pre-publication manuscript audit with 24 diagnostic dimensions, citation hygiene, and cross-element coherence |
  118. | [manuscript-provenance](skills/manuscript-provenance/) | Computational provenance audit verifying every number, table, and figure in a manuscript traces back to code |
  119. | [manuscript-typography](skills/manuscript-typography/) | Academic typography audit — booktabs, captions, units, references, page layout, visual hierarchy, and LaTeX polish |
  120. | [repo-sentinel](skills/repo-sentinel/) | Security audit and enforcement for public repos — 12 attack surfaces, pre-release readiness, history scrubbing, CI gates |
  121. | [package-evaluator](skills/package-evaluator/) | Report-v2 static PASS/FAIL and live NOT_MEASURED interpretation, with separate authored findings and authorized behavioral evidence |
  122. | [devils-advocate](skills/devils-advocate/) | Challenges AI-generated plans, code, designs, and decisions — pre-mortem, inversion, Socratic questioning with steel-manning and clear verdicts |
  123. | [dependency-audit](skills/dependency-audit/) | Dependency risk assessment — license compliance, maintenance health scoring, CVE detection, bloat identification, supply chain analysis |
  124. | [qa-systematic](skills/qa-systematic/) | Systematic web QA testing with 8-category health scoring, issue taxonomy, and regression tracking — full, quick, and regression modes |
  125. | [usage-audit](skills/usage-audit/) | Evidence-backed agent setup and instruction health audit with private offline review, exact-change approval, and drift verification |
  126. | [ux-expert](skills/ux-expert/) | UX audit and redesign for B2B SaaS dashboards — 8-dimension analysis, wireframes, component recommendations, severity-ranked findings |
  127. ### Skills — Visualization & Documents
  128. | Skill | Description |
  129. | -------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
  130. | [architecture-diagram](skills/architecture-diagram/) | Editable SVG architecture diagrams with native AWS/Azure/GCP icons, deterministic zone-aware layout |
  131. | [concept-to-image](skills/concept-to-image/) | Turn concepts into polished HTML visuals, export as PNG or SVG |
  132. | [animate](skills/animate/) | Manim explainers with deterministic JSON/TOML templates, editable Python scenes, MP4/WebM/GIF output, audio overlay, local verification and frame-review receipts |
  133. | [html-video](skills/html-video/) | Video authored as HTML and CSS and rendered to MP4 with a pinned, project-local Hyperframes CLI — bundled templates, offline authoring and verification, user-supplied fonts |
  134. | [launch-video](skills/launch-video/) | Launch video of the current project — storyboard, tone presets, real UI in HTML/CSS rendered via html-video, poster baked into frame 0, share copy with enforced CC BY credits |
  135. | [remotion-video](skills/remotion-video/) | Production motion graphics using Remotion (React) — branded content, data-driven video, audio sync, TailwindCSS |
  136. | [html-presentation](skills/html-presentation/) | Convert documents and outlines into self-contained HTML slide presentations |
  137. | [marp-slides](skills/marp-slides/) | Author MARP Markdown slide decks exportable to PDF, PPTX, and HTML via marp-cli |
  138. | [repo-tutor](skills/repo-tutor/) | Teach a local or remote repository through an evidence-grounded, multipage offline HTML learning guide |
  139. | [static-web-artifacts-builder](skills/static-web-artifacts-builder/) | Self-contained interactive HTML artifacts — infographics, dashboards, diagrams |
  140. | [md-to-pdf](skills/md-to-pdf/) | Markdown to styled PDF with Mermaid diagrams, KaTeX math, and syntax highlighting |
  141. ### Skills — Documentation & Release
  142. | Skill | Description |
  143. | ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
  144. | [changelog-composer](skills/changelog-composer/) | Structured changelogs from git history — conventional commit parsing, audience filtering, breaking change detection |
  145. | [ship-workflow](skills/ship-workflow/) | Resumable shipping lifecycle — dirty or committed work through logical commits, PR, current CI and review gates, guarded merge, and proof-based cleanup; narrower requests keep their endpoint, and no version or changelog changes |
  146. | [engineering-retro](skills/engineering-retro/) | Git-based engineering retrospective — commit analysis, velocity metrics, session patterns, health scoring over time windows |
  147. | [adr-writer](skills/adr-writer/) | Architecture Decision Records — context capture, alternatives analysis, consequence projection, status lifecycle |
  148. | [api-docs-generator](skills/api-docs-generator/) | API documentation audit and enhancement — FastAPI docstrings, Pydantic examples, OpenAPI spec enrichment, coverage reports |
  149. | [arxiv-preflight](skills/arxiv-preflight/) | arXiv submission readiness audit across TeX source, PDF, figures, metadata, bibliography, and file organization |
  150. | [arxiv-figures](skills/arxiv-figures/) | Optimize and convert figures for arXiv processor constraints, file formats, and size limits |
  151. | [arxiv-package](skills/arxiv-package/) | Package TeX/LaTeX projects into clean tarballs or zip archives ready for arXiv upload |
  152. ### Skills — Backend & Data
  153. | Skill | Description |
  154. | ---------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
  155. | [sql-optimizer](skills/sql-optimizer/) | SQL performance analysis — EXPLAIN interpretation, anti-pattern detection, index recommendations, rewrites |
  156. | [migration-risk-analyzer](skills/migration-risk-analyzer/) | Database migration risk assessment — lock analysis, downtime estimation, rollback strategies, validation |
  157. | [benchmark-runner](skills/benchmark-runner/) | Structured benchmark design — metric selection, test case matrix, environment capture, statistical rigor |
  158. ### Skills — Business Validation
  159. | Skill | Description |
  160. | ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
  161. | [idea-validator](skills/idea-validator/) | Full business idea validation orchestrator — Lean Canvas, JTBD, parallel market/competitive/feasibility agents, SWOT/PESTLE, weighted scoring |
  162. | [market-analyzer](skills/market-analyzer/) | Market sizing and trend analysis — TAM/SAM/SOM calculation, Rogers adoption curve, data triangulation, timing assessment |
  163. | [competitive-analyzer](skills/competitive-analyzer/) | Competitive landscape analysis — Porter's Five Forces, feature/pricing matrices, positioning maps, moat taxonomy |
  164. | [feasibility-assessor](skills/feasibility-assessor/) | Financial and technical feasibility — unit economics (CAC/LTV), revenue modeling, break-even, technical risk scoring, build-vs-buy |
  165. | [intake](skills/intake/) | Draft one external recipient's asynchronous discovery questionnaire with outcome coverage; not live elicitation, survey analytics, or repository onboarding |
  166. ### Skills — AI/ML & Planning
  167. | Skill | Description |
  168. | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
  169. | [prompt-lab](skills/prompt-lab/) | Systematic prompt engineering — variant generation, evaluation rubrics, failure mode analysis, test suites |
  170. | [rag-auditor](skills/rag-auditor/) | RAG pipeline evaluation — retrieval metrics, generation quality, failure taxonomy, diagnostic queries |
  171. | [task-decomposer](skills/task-decomposer/) | Feature decomposition — phased task breakdown, dependency mapping, edge case enumeration, sizing |
  172. | [estimate-calibrator](skills/estimate-calibrator/) | Calibrated three-point estimates — PERT ranges, unknown identification, confidence intervals, bias correction |
  173. ### Skills — Writing
  174. | Skill | Description |
  175. | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  176. | [humanize](skills/humanize/) | Prose editing with deterministic Markdown-aware scanning, selected mechanical cleanup, and preservation checks; contextual rewriting and voice matching remain judgment tasks |
  177. | [linkedin-post-style](skills/linkedin-post-style/) | Write LinkedIn posts in a specific technical voice with optional visual companions — carousels via md-to-pdf, images via concept-to-image, and temporal-subject video via the engine you name: html-video (Hyperframes), animate (Manim), or remotion-video (React) |
  178. ### Skills — Skill Evolution (EvoSkills)
  179. | Skill | Description |
  180. | ------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------- |
  181. | [paper-to-skill](skills/paper-to-skill/) | Convert research papers into executable skill packages via methodology extraction and co-evolutionary refinement |
  182. | [skill-distiller](skills/skill-distiller/) | Distill Opus-quality skill packages into deterministic, Haiku-executable workflows via trace-driven distillation |
  183. | [surrogate-verifier](skills/surrogate-verifier/) | Information-isolated verification generating structured test assertions and failure diagnostics for skills |
  184. > _Research lineage:_ the EvoSkills pipeline (arXiv 2604.01687) handles offline co-evolutionary refinement. The `immune` skill together with armory's auto-memory system implements the **stateful-prompt** concept from Memento-Skills (arXiv 2603.18743) — the read-write reflective loop for continual learning without parameter updates.
  185. ### Skills — Deprecated (Archived)
  186. Skills below are superseded by base model capabilities or retired migration guidance. Their source is retained for reference under `archive/skills/`, outside the active `skills/` tree. They are excluded from standard discovery, installation, the manifest, and generated adapters, and receive no further updates.
  187. | Skill | Reason |
  188. | ---------------------------------------------------------- | ------------------------------------------------------------ |
  189. | [doc-condenser](archive/skills/doc-condenser/) | Base model handles summarization natively |
  190. | [regex-builder](archive/skills/regex-builder/) | Base model generates regex at equivalent quality |
  191. | [sequential-thinking](archive/skills/sequential-thinking/) | Base model handles chain-of-thought natively |
  192. | [opus-4-7-migration](archive/skills/opus-4-7-migration/) | Opus 4.7 migration guidance deprecated; no longer maintained |
  193. ## Rules
  194. | Rule | Description |
  195. | ----------------------------------------------- | ---------------------------------------------- |
  196. | [adaptive-thinking-control](rules/adaptive-thinking-control/) | Prompt-level control for Opus 4.7 adaptive thinking and effort-level trade-offs |
  197. | [commit-standards](rules/commit-standards/) | Conventional commit format, branch naming |
  198. | [intent-discipline](rules/intent-discipline/) | Surface assumptions, minimum-viable code, surgical diffs, verifiable success criteria |
  199. | [test-standards](rules/test-standards/) | Coverage thresholds, test quality requirements |
  200. | [security-standards](rules/security-standards/) | Secret management, input validation, auth |
  201. | [token-efficiency](rules/token-efficiency/) | Token-efficient tool usage patterns |
  202. ## Commands
  203. | Command | Description |
  204. | ---------------------------------------- | -------------------------------- |
  205. | [tdd](commands/tdd/) | Test-driven development workflow |
  206. | [security-scan](commands/security-scan/) | Security vulnerability audit |
  207. | [refactor](commands/refactor/) | Code simplification workflow |
  208. | [evolve](commands/evolve/) | Co-evolutionary skill generation |
  209. | [handoff](commands/handoff/) | Refresh or scaffold `.docs/handoff.md` |
  210. | [route](commands/route/) | Package discovery and task-to-package routing |
  211. | [ship](commands/ship/) | Ship work through the ship-workflow lifecycle — full ship to cleanup by default, narrower endpoints on request |
  212. | [stack-pr](commands/stack-pr/) | Stacked PR workflow command surface |
  213. | [decision-map](commands/decision-map/) | Slash-command surface for charting and working decision maps |
  214. | [librarian](commands/librarian/) | Explicit capture, status, and review for reusable skill observations |
  215. ## Hooks
  216. | Hook | Description |
  217. | ----------------------------------------- | ---------------------------------------------------- |
  218. | [git-protection](hooks/git-protection/) | Block dangerous git operations |
  219. | [pre-edit-backup](hooks/pre-edit-backup/) | Backup files before edits |
  220. | [cost-tracker](hooks/cost-tracker/) | Log session cost/token usage |
  221. | [anatomy-index](hooks/anatomy-index/) | Maintain project file index with token estimates |
  222. | [read-dedup](hooks/read-dedup/) | Warn on duplicate file reads within a session |
  223. | [prompt-context](hooks/prompt-context/) | Inject text file as additionalContext on every prompt |
  224. | [handoff-on-stop](hooks/handoff-on-stop/) | Refresh `.docs/handoff.md` on Stop when present |
  225. | [simplify-ignore](hooks/simplify-ignore/) | Collapse protected code regions before agent reads |
  226. | [stack-guard](hooks/stack-guard/) | Add stacked-PR-specific git safety checks |
  227. ## Utilities
  228. | Utility | Description |
  229. | ------------------------------------------------------- | -------------------------------------------------------- |
  230. | [arxiv-search](utilities/arxiv-search/) | Search arXiv for papers, output structured JSON metadata |
  231. | [dependency-tree](utilities/dependency-tree/) | Visualize project dependency graph |
  232. | [skill-inventory](utilities/skill-inventory/) | Measure local skill exposure and propose reversible OMP quarantine |
  233. | [test-coverage-report](utilities/test-coverage-report/) | Coverage summary for changed files |
  234. ## Presets
  235. Presets install curated bundles of passive packages (rules, hooks, commands) in one command. For active workflow orchestration, use agents instead.
  236. | Preset | Packages | Description |
  237. | --------------------------------------- | ------------------------------------------------ | ----------------------------------------------------------------------------------------------- |
  238. | [core](presets/core/) | 3 skills, 1 hook, 1 rule | Baseline review-commit lifecycle. Start here. |
  239. | [sec-strict](presets/sec-strict/) | 5 skills, 3 agents, 2 rules, 2 hooks, 1 command | Audit-grade security stack with codebase-auditor. Superset of `core`. |
  240. | [python-strict](presets/python-strict/) | 4 skills, 2 agents, 3 rules, 2 hooks, 2 commands | Full Python enforcement — TDD, type checking, test coverage, security standards. |
  241. | [ai-builder](presets/ai-builder/) | 6 skills | AI/ML development toolkit — agent building, prompt engineering, GPU optimization, RAG auditing. |
  242. | [skill-evolution](presets/skill-evolution/) | 6 skills, 1 agent, 1 command | EvoSkills pipeline — co-evolutionary skill factory with paper-to-skill, distillation, and verification. |
  243. | [terse-mode](presets/terse-mode/) | 1 hook | Terse output enforcement via prompt-context hook with compaction-immune rule injection. |
  244. | [session-continuity](presets/session-continuity/) | 1 skill, 1 command, 1 hook | Atomic handoff install: `/handoff`, greenfield scaffold, and opt-in Stop refresh gated by `.docs/handoff.md`. |
  245. | [stack-workflow](presets/stack-workflow/) | 4 skills, 1 command, 2 hooks | Complete stacked PR bundle with topology policy, lifecycle execution, guard hooks and review gates. |
  246. ### Deprecated Presets
  247. Superseded by orchestrator agents that provide autonomous workflow orchestration instead of manual skill invocation.
  248. | Preset | Replacement |
  249. | ------------------ | ----------------------------------------------- |
  250. | [biz-validation](presets/biz-validation/) | `idea-scout` agent |
  251. | [media-craft](presets/media-craft/) | `media-producer` agent |
  252. | [content-ops](presets/content-ops/) | `content-strategist` agent |
  253. | [research](presets/research/) | `research-analyst` agent |
  254. | [eng-ops](presets/eng-ops/) | `ship-workflow` skill + `release-captain` + `full-stack-builder` agents |
  255. ## Native Extensions
  256. Native extensions (`extensions/<feature>/EXTENSION.md`) are optional executable modules for OMP and Claude Code. Each feature keeps deterministic rules in a pure shared core and ships one self-contained artifact per host: an OMP package (`package.json` with `omp.extensions`) and a Claude Code mod (`.claude-plugin/plugin.json` plus `hooks/hooks.json`).
  257. | Extension | Capability | Exercised native surface |
  258. | --- | --- | --- |
  259. | [verification-receipts](extensions/verification-receipts/) | Run explicitly configured local checks; retain private exact results/output and recompute scoped freshness | OMP 18.12.6 RPC and Claude Code 2.1.309 interactive, macOS arm64 |
  260. | [resume-brief](extensions/resume-brief/) | Record/reopen source-linked project cards; expose changed facts and non-executable approval holds | OMP 18.12.6 RPC and Claude Code 2.1.309 interactive/headless, macOS arm64 |
  261. | [delivery-radar](extensions/delivery-radar/) | Read an explicit PR selection; separate implementation, verification, review, merge and publication without remote actions | OMP 18.12.6 RPC and Claude Code 2.1.310 interactive/headless, macOS arm64 |
  262. | [run-preflight](extensions/run-preflight/) | Check explicit OMP managed-run prerequisites; retain unknown quota and consume current admission at the owned dispatch boundary; optional harmless local sentinel | OMP 18.12.6 RPC and Claude Code 2.1.310 interactive/headless, macOS arm64 |
  263. Extensions are never installed by profiles, presets, the interactive installer, "all" or the all-in-one Claude plugin. Install, update, disable or remove one explicitly per host:
  264. ```bash
  265. uv run python scripts/install.py --type extension --platform omp \
  266. --name <feature> --action install --target-root ~/.omp/agent --yes
  267. uv run python scripts/install.py --type extension --platform claude \
  268. --name <feature> --action install --target-root ~/.claude --yes
  269. ```
  270. For OMP the payload goes to the documented discovery directory `<root>/extensions/<feature>/`, and `--action disable` adds `extension-module:<feature>` to `disabledExtensions` in `<root>/config.yml`. For Claude Code the payload goes to `<root>/.armory-native/claude-plugins/<feature>/` and is registered in `env.CLAUDE_CODE_PLUGIN_DIRS` in `<root>/settings.json`; disable removes exactly that entry. Removal deletes only unchanged files Armory installed and the exact registration it added; extension data and foreign configuration stay. To try a built artifact for one session instead, run `omp --extension <artifact>/index.ts` or `claude --plugin-dir <artifact>`. Extensions require [Bun](https://bun.sh) for bundled helpers. Compatibility is claimed only for host versions and surfaces a feature records as actually exercised. See [CONTRIBUTING.md](CONTRIBUTING.md#extension-extensionmd) for the package contract.
  271. Claude's development `--plugin-dir` loader generates SDK files in the supplied directory. Use a disposable artifact copy for that workflow, separate from the managed installation payload; unknown generated files must not be deleted or accepted as Armory-owned to force an update/removal. See the feature's operator guide for explicit configuration, conservative cancellation semantics and fail-closed local/manual qualification. Credential-free CI validates deterministic behavior and distribution, not authenticated native compatibility.
  272. ---
  273. ## Installation
  274. **Option 1 — Skills CLI (recommended)**
  275. Install any skill directly using [`npx skills`](https://github.com/vercel-labs/skills):
  276. ```bash
  277. # Install all skills
  278. npx skills add Mathews-Tom/armory
  279. # Install a specific skill
  280. npx skills add Mathews-Tom/armory -s architecture-reviewer
  281. npx skills add Mathews-Tom/armory -s codebase-advisor
  282. # List available skills without installing
  283. npx skills add Mathews-Tom/armory -l
  284. ```
  285. **Option 2 — Profile installer**
  286. ```bash
  287. git clone https://github.com/Mathews-Tom/armory.git
  288. cd armory
  289. # Install by profile
  290. just install-profile core
  291. just install-profile python-strict
  292. # Install by type
  293. uv run scripts/install.py --type skill
  294. uv run scripts/install.py --type agent
  295. # Interactive TUI
  296. uv run scripts/install.py
  297. ```
  298. Displays a version-aware table of all packages, detects installed versions, and lets you select which to install or upgrade. Profiles install curated bundles of packages across all types.
  299. The profile installer validates manifest declarations, or definition frontmatter when no manifest exists, and resolves every package named by a selected profile before writing the installation destination. Malformed declarations, missing declared source directories, and unresolved profile entries stop installation with a diagnostic naming the offending declaration. Combine `--profile core --type skill` to resolve the profile across all package types and install only its skills.
  300. Preset selections validate cross-type package discovery before creating the destination. Adapter generation and installation reject invalid definition frontmatter before replacing existing generated output.
  301. **Option 3 — Claude Code plugin marketplace (skills, agents, commands only)**
  302. ```bash
  303. claude plugin marketplace add Mathews-Tom/armory
  304. /plugin install armory
  305. ```
  306. This uses Claude Code's native plugin system and loads a subset of armory's catalog.
  307. | Package type | Supported via plugin marketplace |
  308. | ------------ | -------------------------------- |
  309. | skills | ✅ yes |
  310. | agents | ✅ yes |
  311. | commands | ✅ yes |
  312. | hooks | ❌ no — requires the profile installer |
  313. | rules | ❌ no — armory-specific type, not a Claude Code plugin concept |
  314. | utilities | ❌ no — armory-specific type, not a Claude Code plugin concept |
  315. | presets | ❌ no — use `just install-profile` instead |
  316. | extensions | ❌ no — native modules; never enabled by the all-in-one plugin (see [Native Extensions](#native-extensions)) |
  317. The Skills CLI (Option 1) installs only `SKILL.md` packages, so it skips agents, hooks, rules, commands, utilities and presets; the `skill-inventory` skill can install the same-name utility from the rolling release. For the full catalog across the seven copy-installed package types, use Option 2 (profile installer); native extensions install only through the explicit extension lifecycle.
  318. **Option 4 — Manual**
  319. Clone the repo and symlink individual package folders:
  320. ```bash
  321. git clone https://github.com/Mathews-Tom/armory.git
  322. # Skills
  323. ln -s "$(pwd)/armory/skills/architecture-reviewer" ~/.claude/skills/architecture-reviewer
  324. ln -s "$(pwd)/armory/skills/codebase-advisor" ~/.claude/skills/codebase-advisor
  325. # Agents
  326. ln -s "$(pwd)/armory/agents/codebase-auditor" ~/.claude/agents/codebase-auditor
  327. ```
  328. Or download `.skill` / `.agent` archives from the [Releases](../../releases) page.
  329. ---
  330. ## Usage
  331. Packages activate when Claude detects a matching intent. Each package defines trigger phrases in its frontmatter description — check the definition file (`SKILL.md`, `AGENT.md`, etc.) in each folder.
  332. **Example triggers:**
  333. ```text
  334. "Run a security audit before I push this to GitHub"
  335. -> activates: repo-sentinel (skill)
  336. "Review this code for quality issues"
  337. -> activates: code-reviewer (agent)
  338. "Evaluate the quality of this package"
  339. -> activates: package-evaluator (skill)
  340. ```
  341. **Commands** are invoked explicitly via slash syntax:
  342. ```text
  343. /tdd calculate_discount -> TDD workflow for a function
  344. /security-scan src/ -> security vulnerability audit
  345. /refactor src/utils.py -> code simplification
  346. ```
  347. **Hooks** fire automatically on Claude Code lifecycle events (PreToolUse, PostToolUse, Stop, UserPromptSubmit). **Rules** load as context when relevant. **Presets** install bundles via `just install-profile`.
  348. ---
  349. ## Package Quality
  350. The [package-evaluator](skills/package-evaluator/) separates three evidence sources:
  351. - **Machine conformance:** `scripts/evaluate_package.py --path skills/my-skill-name --json` emits report-v2 records with static conformance `PASS` or `FAIL` and live effectiveness `NOT_MEASURED`. Static checks do not establish routing or task outcomes.
  352. - **Authored findings:** source-backed review of observable completion, distinct invocation branches, conditional reference loading, configuration discovery and type-specific contracts. These findings remain separate from machine status.
  353. - **Authorized behavioral evidence:** actual invocations, artifacts, observations and limits, recorded only when execution is separately authorized. Unexercised behavior stays unmeasured; a static pass or authored case does not establish effectiveness.
  354. See [CONTRIBUTING.md](CONTRIBUTING.md#quality-gate--static-conformance-and-authored-review) for submission requirements and the current evaluator interface. There is no weighted package-quality score or percentage acceptance threshold.
  355. ---
  356. ## Eval Coverage
  357. Every active package has eval cases in `{type}/<name>/evals/cases.yaml` — positive triggers (should activate) and negative triggers (should not). Deprecated skill evals retain no positive cases and at least two negative cases; the skills live under `archive/skills/<name>/`, outside the active tree. Deprecated presets remain under `presets/`.
  358. **Validation:**
  359. ```bash
  360. uv run scripts/validate_evals.py # Schema validation for all eval files
  361. uv run scripts/generate_manifest.py # Regenerate manifest.yaml
  362. ```
  363. **CI pipeline** (`.github/workflows/evals.yml`):
  364. - **PR gate**: validates manifest synchronization and eval schemas across all registered package types
  365. - **Weekly cron**: Monday runs for model drift detection
  366. **Pre-commit hook**: auto-regenerates `manifest.yaml` when any package definition file changes.
  367. ---
  368. ## MCP Server
  369. An MCP server exposes armory packages as discoverable tools for any agent session. Register in your Claude Code config:
  370. ```json
  371. {
  372. "mcpServers": {
  373. "armory": { "command": "uv", "args": ["run", "mcp/server.py"] }
  374. }
  375. }
  376. ```
  377. **Available tools:**
  378. | Tool | Description |
  379. | -------------------- | ------------------------------------------------------------- |
  380. | `search_packages` | Keyword search with type, category, and tag filters |
  381. | `get_package` | Full metadata for a single package by name |
  382. | `recommend_packages` | Context-aware recommendations by language, framework, or task |
  383. | `list_categories` | All categories with package counts |
  384. ---
  385. ## Spec Compliance
  386. Skills are validated against the [agentskills.io](https://agentskills.io) open standard:
  387. ```bash
  388. uv run scripts/validate_agentskills.py # Warnings only (default)
  389. uv run scripts/validate_agentskills.py --strict # Extra fields are errors
  390. ```
  391. The validator checks discovered skills against the agentskills.io frontmatter spec (name, description, license, compatibility, metadata, allowed-tools) and flags Claude Code-specific fields as warnings.
  392. ---
  393. ## Packaging
  394. Each package can be archived for distribution. Archive type is auto-detected from the directory:
  395. ```bash
  396. uv run scripts/package.py skills/architecture-reviewer # produces .skill
  397. uv run scripts/package.py agents/code-reviewer # produces .agent
  398. uv run scripts/package.py hooks/git-protection # produces .hook
  399. ```
  400. ---
  401. ## Cross-Platform Adapters
  402. Packages are authored as Claude Code-native definitions. The adapter generator transforms them into platform-specific formats for Cursor, OpenAI Codex, and Gemini CLI.
  403. ### Generate
  404. ```bash
  405. # All platforms
  406. uv run scripts/generate_adapters.py
  407. # Single platform
  408. uv run scripts/generate_adapters.py --platform cursor
  409. uv run scripts/generate_adapters.py --platform codex
  410. uv run scripts/generate_adapters.py --platform gemini
  411. # Filter by package type
  412. uv run scripts/generate_adapters.py --platform cursor --type skills --type rules
  413. # Preview without writing
  414. uv run scripts/generate_adapters.py --dry-run
  415. ```
  416. Output lands in `adapters/{platform}/` (gitignored — generated, not source).
  417. ### Platform Mapping
  418. | Armory Type | Cursor | Codex | Gemini |
  419. | ------------- | ---------------------------------------- | --------------------- | --------------------------------------- |
  420. | **Skills** | `.cursor/rules/{name}.mdc` | `skills/AGENTS.md` | `.gemini/skills/{name}/SKILL.md` |
  421. | **Agents** | `.cursor/rules/{name}.mdc` | `agents/AGENTS.md` | `.gemini/agents/{name}.md` |
  422. | **Rules** | `.cursor/rules/{name}.mdc` (alwaysApply) | `standards/AGENTS.md` | Sections in `GEMINI.md` |
  423. | **Commands** | `.cursor/commands/{name}.md` | `workflows/AGENTS.md` | `.gemini/commands/workflow/{name}.toml` |
  424. | **Hooks** | — | — | — |
  425. | **Utilities** | — | — | Wrapped as `.gemini/skills/` |
  426. | **Presets** | — | — | — |
  427. ### Quick Install (no Python required)
  428. Download pre-built adapter packages from the latest release:
  429. ```bash
  430. # Cursor
  431. npx @anthropic-armory/installer --target cursor
  432. # Codex
  433. npx @anthropic-armory/installer --target codex
  434. # Gemini
  435. npx @anthropic-armory/installer --target gemini --dir /path/to/project
  436. ```
  437. Or download directly from [GitHub Releases](../../releases):
  438. ```bash
  439. # Cursor — extract .cursor/ into your project root
  440. curl -sL https://github.com/Mathews-Tom/armory/releases/download/latest/armory-cursor.tar.gz | tar -xz
  441. # Codex — extract AGENTS.md + subdirectories into project root
  442. curl -sL https://github.com/Mathews-Tom/armory/releases/download/latest/armory-codex.tar.gz | tar -xz
  443. # Gemini — extract .gemini/ into your project root
  444. curl -sL https://github.com/Mathews-Tom/armory/releases/download/latest/armory-gemini.tar.gz | tar -xz
  445. ```
  446. ### Install via Python (with TUI)
  447. The Python installer supports all targets with `--target`:
  448. ```bash
  449. uv run scripts/install.py --target cursor --project-dir /path/to/project
  450. uv run scripts/install.py --target codex --project-dir /path/to/project
  451. uv run scripts/install.py --target gemini --project-dir /path/to/project
  452. ```
  453. ### Generate Locally
  454. Generate adapter output from source (requires Python 3.12):
  455. ```bash
  456. uv run scripts/generate_adapters.py --platform cursor
  457. uv run scripts/generate_adapters.py --platform codex
  458. uv run scripts/generate_adapters.py --platform gemini
  459. ```
  460. Output lands in `adapters/{platform}/` (gitignored — generated, not source).
  461. ### Platform Details
  462. **Cursor**: Rules with `alwaysApply: true` (project standards) load on every prompt. Skills and agents load when Cursor matches the description or glob pattern.
  463. **Codex**: The root `AGENTS.md` is a condensed index under the 32 KiB budget. Full content is in subdirectory `AGENTS.md` files, loaded via Codex's hierarchical discovery.
  464. **Gemini**: Skills are a near 1:1 copy (references, scripts, and assets included). Rules become sections in `GEMINI.md`. Commands are converted to TOML format.
  465. ### What's Lost
  466. Not all package types have equivalents on every platform:
  467. - **Hooks** have no equivalent on Cursor or Codex. Gemini has hooks but uses a different event model.
  468. - **Presets** require a dependency resolver that no target platform provides.
  469. - **Utilities** with executable scripts are skipped on Cursor and Codex (passive context only). Gemini wraps them as skills.
  470. ---
  471. ## Contributing
  472. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on submitting new packages or improving existing ones.
  473. Looking for something to build? Check [WANTED.md](WANTED.md) for missing skill domains, requested agents, and infrastructure improvements.
  474. ---
  475. ## Contributors
  476. See [CONTRIBUTORS.md](CONTRIBUTORS.md) for the full list.
  477. ---
  478. ## Attributions
  479. See [ATTRIBUTIONS.md](ATTRIBUTIONS.md) for the full list of upstream libraries, tools, and projects that armory packages wrap, depend on, or were inspired by.
  480. ---
  481. ## License
  482. MIT. See [LICENSE](LICENSE) for details.
  483. ---
  484. > **Migrated from praxis-skills.** If you had skills installed from the previous repo,
  485. > re-run the installer to update paths. Existing skills continue to work — the content
  486. > is unchanged.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.