Alanistic Skills (Codex + Claude Code)

Production-grade engineering and output-format skills packaged for OpenAI Codex and Claude Code.

Originally derived from addyosmani/agent-skills, this repo keeps the reusable skill workflows and strips packaging for other agents (Gemini, Copilot, Cursor, Windsurf, opencode, etc.). Both Codex and Claude Code consume the same SKILL.md format. The repo is a marketplace named alanistic-skills that ships two plugins, dev-skills and output-skills, each with both a Codex (.codex-plugin/plugin.json) and a Claude Code (.claude-plugin/plugin.json) manifest.

Clone the repo:

git clone https://github.com/alangmartini/alanistic-skills.git
cd alanistic-skills

Install one skill on Windows:

$dest = "$env:USERPROFILE\.codex\skills"
New-Item -ItemType Directory -Force $dest
Copy-Item -Recurse .\plugins\dev-skills\skills\test-driven-development $dest

Install all skills on Windows:

$dest = "$env:USERPROFILE\.codex\skills"
New-Item -ItemType Directory -Force $dest
Get-ChildItem .\plugins\dev-skills\skills -Directory | Copy-Item -Destination $dest -Recurse -Force
Get-ChildItem .\plugins\output-skills\skills -Directory | Copy-Item -Destination $dest -Recurse -Force

Restart Codex after installing skills.

On macOS/Linux, Codex skills live in ${CODEX_HOME:-$HOME/.codex}/skills:

mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
cp -R plugins/dev-skills/skills/* "${CODEX_HOME:-$HOME/.codex}/skills/"
cp -R plugins/output-skills/skills/* "${CODEX_HOME:-$HOME/.codex}/skills/"

Claude Code reads SKILL.md files with the same frontmatter Codex uses. Pick one path:

As plugins (recommended). Add this repo as a marketplace and install:

/plugin marketplace add alangmartini/alanistic-skills
/plugin install dev-skills@alanistic-skills
/plugin install output-skills@alanistic-skills

Claude Code auto-discovers skills/*/SKILL.md from each plugin root declared in its .claude-plugin/plugin.json.

As user-level skills. Copy skills into ~/.claude/skills/:

$dest = "$env:USERPROFILE\.claude\skills"
New-Item -ItemType Directory -Force $dest
Get-ChildItem .\plugins\dev-skills\skills -Directory | Copy-Item -Destination $dest -Recurse -Force
Get-ChildItem .\plugins\output-skills\skills -Directory | Copy-Item -Destination $dest -Recurse -Force

mkdir -p "$HOME/.claude/skills"
cp -R plugins/dev-skills/skills/* "$HOME/.claude/skills/"
cp -R plugins/output-skills/skills/* "$HOME/.claude/skills/"

As project-level skills. Copy into .claude/skills/ inside your project to share them via version control.

Restart Claude Code after installing or updating skills.

This repo is a marketplace that ships two plugins:

.claude-plugin/
  marketplace.json                  # lists both plugins (marketplace: alanistic-skills)
plugins/
  dev-skills/
    .claude-plugin/plugin.json      # dev-skills
    .codex-plugin/plugin.json       # dev-skills (Codex)
    skills/                         # engineering workflow skills
  output-skills/
    .claude-plugin/plugin.json      # output-skills
    .codex-plugin/plugin.json       # output-skills (Codex)
    skills/                         # html-output, make-workflow-canvas, make-architecture-flow, make-interactive-visualization, caveman
references/
docs/

The dev-skills plugin covers engineering workflows. The output-skills plugin covers self-contained interactive HTML generation, editable workflow canvases, and the caveman compression mode. Both Codex and Claude Code consume the same SKILL.md format, so each plugin ships both manifests.

Per-agent setup details:

• docs/codex-setup.md — Codex install paths and plugin layout
• docs/claude-setup.md — Claude Code marketplace install, user/project skill folders, troubleshooting

Both Codex and Claude Code read each skill's name and description metadata to decide when to load the full instructions. Keep the description field specific: it should say what the skill does and when the agent should use it.

These ship as a second plugin in the same marketplace, output-skills, living at plugins/output-skills/. Install separately when you want them.

Claude Code install:

/plugin marketplace add alangmartini/alanistic-skills
/plugin install output-skills@alanistic-skills

Codex install (copy the skills directly):

$dest = "$env:USERPROFILE\.codex\skills"
New-Item -ItemType Directory -Force $dest
Get-ChildItem .\plugins\output-skills\skills -Directory | Copy-Item -Destination $dest -Recurse -Force

mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
cp -R plugins/output-skills/skills/* "${CODEX_HOME:-$HOME/.codex}/skills/"

Reference material is intentionally separate from skill entry points so the agent can load it only when needed:

New skills belong under the right plugin's skills/ directory: plugins/dev-skills/skills/<skill-name>/SKILL.md for engineering workflows, plugins/output-skills/skills/<skill-name>/SKILL.md for output-format skills. Each skill must include frontmatter with name and description, and the directory name must match the skill name.

Run the validator before committing:

python scripts/validate-skills.py

Keep this repo scoped to Codex and Claude Code. Do not add command folders, manifests, hooks, or setup guides for other agents (Gemini, Copilot, Cursor, Windsurf, opencode, etc.).