aku aku

ai agent taste, version-controlled.

instructions, skills, configs, workflows, and the occasional strong opinion. part backup, part public goods.

named after Aku Aku, the protective mask power-up from Crash Bandicoot.

fork what hits. remix to taste. leave the rest.

plug it in

clone the repo, cd into it, then make AGENTS.md the source of truth:

mkdir -p "$HOME/.claude" "$HOME/.codex"
ln -sfn "$PWD/AGENTS.md" "$HOME/.claude/CLAUDE.md"
ln -sfn "$PWD/AGENTS.md" "$HOME/.codex/AGENTS.md"

one file, same taste everywhere. the -f replaces anything already living at those two paths, so back it up first if needed.

claude code reads ~/.claude/CLAUDE.md; codex reads ~/.codex/AGENTS.md. both resolve to the file tracked here.

git can preserve symlinks inside a repo, but it cannot install them elsewhere in your home directory. these few commands are the tiny installer.

bootstrap testing

starting a new project, or working in one with no tests yet? point your agent at testing-setup.md and ask it to build the test environment around those preferences.

for example:

set up testing for this project following /path/to/aku-aku/testing-setup.md.
adapt the guide to the project's stack and existing conventions.

this is an optional playbook, not a global instruction. it is intentionally not referenced from AGENTS.md, so it only applies when you explicitly hand it to an agent.

recommended skills and plugins

recommended-skills-and-plugins.md is the shortlist of skills and plugins used most often here, what each one is for, and which ones combine well.

it is a recommendation catalog, not an installer or a global instruction. point an agent at it when choosing capabilities for a project or task; nothing in AGENTS.md loads the list automatically.

skills

skills/ holds skills this repo ships. install them with:

npx skills add sorodrigo/aku-aku

• paranoid-bunch — review code, a change, a plan, or a spec for needless complexity, then decide on each issue.

License

Original material in this repository is available under the MIT License. The Aku Aku character and artwork belong to their respective rights holders and are not covered by that license. Image source.