athena

Athena

Portable repository-review, development, and agent-orchestration skills for Claude Code, Codex, and Pi.

Athena is distributed only as an AI-harness plugin. It does not publish a Python wheel, source distribution, or runtime library.

Required repositories

Athena has two hard dependencies:

Purpose	Default	Owner override	Checkout
Knowledge	HomericIntelligence/Mnemosyne	HOMERIC_INTELLIGENCE_MNEMOSYNE_OWNER	$HOME/.agent_brain/knowledge
Automation	HomericIntelligence/Hephaestus	HOMERIC_INTELLIGENCE_HEPHAESTUS_OWNER	$HOME/.agent_brain/automation

Without an explicit override, Athena prefers a same-named repository in the current repository's GitHub owner only when GitHub verifies it is a fork of the corresponding default. Otherwise it uses the default. An invalid override, authentication failure, checkout mismatch, or update failure is fatal. See docs/dependency-resolution.md.

The knowledge backend is mandatory. learn always uses an isolated worktree and creates a pull request; it never writes directly to the knowledge repository's default branch.

Script-backed skills require Git, GitHub CLI, and Python 3.10 or newer on the host. Athena ships the scripts as plugin resources; it does not install a Python package or third-party runtime library.

Install

Install the section for your harness, then restart it so the skill catalog reloads.

Claude Code

claude plugin marketplace add https://github.com/HomericIntelligence/Athena
claude plugin install athena@Athena

Invoke /athena:repo-review. Update or remove:

claude plugin marketplace update Athena
claude plugin uninstall athena@Athena

Codex

codex plugin marketplace add https://github.com/HomericIntelligence/Athena --ref main
codex plugin add athena@athena
codex plugin list --marketplace athena

Invoke $repo-review or ask Codex to use Athena's repo-review skill. Update or remove:

codex plugin marketplace upgrade athena
codex plugin remove athena@athena
codex plugin marketplace remove athena

Pi

pi install https://github.com/HomericIntelligence/Athena

Invoke /skill:repo-review. Update or remove:

pi update https://github.com/HomericIntelligence/Athena
pi remove https://github.com/HomericIntelligence/Athena

Release archives

Claude Code and Codex install Athena from the Git-backed marketplace sources above. Each GitHub release also provides a checksummed portable archive for offline distribution and provenance; it is not a Python package and does not replace marketplace installation. The archive contains only harness-consumed skills, host metadata, runtime documentation, assets, and notices. It excludes tests, repository scripts, development manifests and lockfiles, task-runner files, CI configuration, and generated development output.

Skills

• Strict repository and PR evaluation: repo-review and pr-review.
• Engineering: brainstorm, systematic-debugging, and test-driven-development.
• Coordination: myrmidon-swarm, git-worktrees, and tidy.
• Knowledge and enablement: advise and learn.

All harnesses consume the same top-level skills/ directory. Missing delegation runs sequentially with the current agent.

Develop

Prerequisites are Git, uv, Just, and Python 3.10+ for repository validation only.

git clone https://github.com/HomericIntelligence/Athena
cd Athena
just bootstrap
just all

just all validates skills and manifests, runs executable unit tests, enforces at least 80% branch coverage for every repository and skill-local executable script, runs Ruff and strict mypy over the same tooling, lints public documentation and workflows, and builds a deterministic plugin archive with a SHA-256 checksum. It never builds Python distribution artifacts.

Layout