shipd-olympus-skill

AI coding-agent skill for shipd.ai Olympus quest submissions. Installs into Claude Code, Cursor, Codex, and any AGENTS.md-based agent, teaching the full rule-compliant workflow: repo eligibility, hard task design, originality sweeps, hidden tests, Dockerfile traps, and offline verification.

Install

# Claude Code, global (recommended)
npx shipd-olympus-skill

# Claude Code, current project only
npx shipd-olympus-skill --project

# Cursor rule
npx shipd-olympus-skill --cursor

# AGENTS.md-based agents (Codex CLI, etc.)
npx shipd-olympus-skill --agents

# All of the above
npx shipd-olympus-skill --all

# Straight from GitHub (no npm publish needed)
npx github:mashhoorahdal/shipd-olympus-skill

Then in Claude Code: /shipd-olympus, or just start working on a submission — the skill auto-triggers.

What it prevents

| Failure | The skill's counter | |---|---| | Picking an easy "good first issue" | Olympus wants SOTA-hard tasks; inverts the instinct | | GPL repo disqualification | Read LICENSE file, never trust the GitHub API field | | Idea killed by a closed PR | Sweeps PRs in all states + issues + Discussions | | Test-name collision check failure | Hash-suffixed test filenames from openssl rand -hex 3 | | Tests passing at base via assert.throws | typeof guard as first assertion | | Broken offline image (missing mocha) | Base image sets NODE_ENV=production → npm ci --include=dev | | Corrupt docker build | Fresh clone; local node_modules pollutes COPY . . | | Description checker trim-loops | Accept derivable-property cuts, defend contract facts |

Docs

Full guide: documentation site · installation · usage · workflow · skill reference

Docs site (VitePress): npm install && npm run docs:dev

Repo layout

skill/SKILL.md    source of truth — the skill itself
bin/cli.js        npx installer (zero dependencies)
docs/             VitePress documentation site

License

MIT