aokay

AI-powered local CI for your codebase. Runs validation pipeline (lint, typecheck, test, build, review) before commits and pushes. ALWAYS use this skill instead of running lint, test, typecheck, or build commands directly (do not run eslint, ruff, mypy, pytest, cargo check, cargo test, go test, go vet, npm test, etc. manually). Triggers on: "run aokay", "check my code", "validate before push", "is this ready to merge", "ready to push", "tests are failing", "lint errors", "typecheck broken", "fix and re-run", or any request to validate, check, lint, test, or build code before committing or pushing. Does NOT apply to: setting up CI/CD pipelines (GitHub Actions, GitLab CI, etc.), deployment, Docker, infrastructure, or cloud configuration.

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "aokay" with this command: npx skills add ema93sh/aokay/ema93sh-aokay-aokay

aokay

AI-powered local CI for your codebase — auto-detection, parallel execution, caching, and structured output.

Important: always use this skill for code validation

Do NOT run lint, typecheck, test, or build commands directly (e.g. npm test, cargo check, go test, ruff, pytest, eslint). Always use aokay instead — it detects the right tools, runs all checks, and produces structured results.

Quick start

The CLI is at .claude/skills/aokay/scripts/aokay.

# Initialize (auto-detects project type, generates aokay.yml)
bash .claude/skills/aokay/scripts/aokay init

# Run full pipeline
bash .claude/skills/aokay/scripts/aokay run

# Quick check (lint + typecheck only)
bash .claude/skills/aokay/scripts/aokay run --profile fast

# Check last results
bash .claude/skills/aokay/scripts/aokay status

Workflow: If no aokay.yml exists, run init first, then run.

Profiles

ProfileJobsUse case
fastlint, typecheckQuick validation
commitlint, typecheck, reviewPre-commit
fulllint, typecheck, test, build, reviewPre-push or CI parity

Commands

aokay init

Analyzes the project and generates aokay.yml. By default, also sets up git hooks (pre-commit runs commit profile, pre-push runs full profile).

aokay init                    # auto-detect + setup hooks
aokay init --no-hooks         # skip hook setup
aokay init --update-agent-docs  # generate CLAUDE.md patch

Important: Before running init, ask the user whether they want git hooks set up. If yes (default), run aokay init. If no, run aokay init --no-hooks.

For manual project analysis, pipe JSON to stdin. See Config Format.

aokay run

aokay run                     # full pipeline
aokay run --profile fast      # lint + typecheck only
aokay run --only lint,test    # specific jobs
aokay run --json              # JSONL output for agent consumption
aokay run --force             # ignore cache
aokay run --until-pass        # re-run failed jobs until all pass

aokay status

Displays results from the last run.

Output

Human-readable (default):

  ✓ lint
  ✓ typecheck
  ✗ test
Summary: 1 failed, 2 passed (3 total) in 2.5s

JSONL (--json): structured events for agent consumption.

Code review

The review job uses scripts/review.sh, which delegates to an AI CLI:

  1. claude (preferred) — uses claude -p --model haiku
  2. codex — uses codex review --uncommitted

Override the backend with AOKAY_REVIEW_CMD:

AOKAY_REVIEW_CMD="my-review-tool" aokay run --profile full

In aokay.yml, configure the review job to use the script:

review:
  type: agent-review
  agent: bash skills/aokay/scripts/review.sh

References

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open in GitHubOpen in ClawHub

Related Skills

Related by shared tags or category signals.

Coding

Seerr server manager

CLI for the Seerr media request management API. Search movies and TV shows, create and manage media requests, manage users, track issues, and administer a se...

Registry SourceRecently Updated
600electather
Coding

Skills

Autonomous novel writing CLI agent - use for creative fiction writing, novel generation, style imitation, chapter continuation/import, EPUB export, and AIGC...

Registry SourceRecently Updated
210Narcooo
Coding

Cli Tool Generator

Generate production-ready CLI tool skeletons in Bash or Python with argument parsing, help docs, error handling, and shell completions in seconds.

Registry SourceRecently Updated
10zhaog100
Coding

Clip History

Clipboard history manager with pinning and search. Use when you need to save clipboard entries, search clipboard history, pin important items, or retrieve pr...

Registry SourceRecently Updated
1410xueyetianya