shipd-olympus-skill

npm version npm downloads license

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