◉ Pulse
ainative-build avatar
#45 today

ainative-build/skills

AI #agent-skills #claude-code #code-review #codex

Portable, self-contained coding-agent skills

Created Jul 22, 2026
Stars
6
Today
+6
Forks
0
Quality
95/100
Momentum
20

README

Fetched from GitHub on Nov 16, 2026, 5:20 PM UTC · README.md

View original on GitHub

Third-party content — Open Source Pulse is not the owner of this repository.

This README belongs to ainative-build/skills and its contributors. We fetch it directly from the project’s public GitHub repository and display it for reference only. All text, code, images and trademarks remain the property of their respective authors. See the repository for its license terms. Copyright / takedown policy.

AI Factory: a chef on a catwalk supervises a factory line that runs plan, serve, test, review and ship

Latest release MIT license Runs on Claude Code, Codex, oh-my-pi and Cursor 18 skills, 14 agents

Development-cycle skills, agents, rules and hooks for coding agents.
One source tree runs on Claude Code, Codex, oh-my-pi (OMP) and Cursor. It is self-contained, with no other CLI or service to install.

How it runs · Quick start · Skills · Test-first · Pro-max · Chef · Agents · Install


How the kitchen runs

Work moves down one line, from a raw idea to a shipped change. Each station is a skill, and aif-chef watches from the catwalk when you ask it to.

%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#fff1e8', 'primaryTextColor': '#2b1510', 'primaryBorderColor': '#ff5a1f', 'lineColor': '#d9481f', 'secondaryColor': '#ffe2d1', 'tertiaryColor': '#fff8f3', 'clusterBkg': '#fff8f3', 'clusterBorder': '#ff9a3c', 'edgeLabelBackground': '#fff1e8', 'actorBkg': '#fff1e8', 'actorBorder': '#ff5a1f', 'signalColor': '#d9481f', 'noteBkgColor': '#ffe2d1', 'noteBorderColor': '#ff9a3c', 'sequenceNumberColor': '#ffffff'}}}%%
flowchart LR
    idea([Idea]) --> shape
    subgraph shape [Shape]
        direction TB
        advise[aif-advise] ~~~ brainstorm[aif-brainstorm] ~~~ research[aif-research]
    end
    shape --> plan[aif-plan]
    plan --> serve
    subgraph serve [Serve: test-first]
        direction TB
        red[Write failing tests<br/>with aif-test] --> green[Implement until green] --> refactor[Refactor, still green]
    end
    serve --> review[aif-code-review]
    review --> ship[aif-ship]
    ship --> done([Merged and released])
    review -. findings .-> fix[aif-debug / aif-fix]
    fix -. fixed with a failing test first .-> review
    chef{{aif-chef}} -. counsel at checkpoints .-> plan
    chef -.-> serve
    chef -.-> review

    classDef station fill:#ff5a1f,stroke:#b8360f,color:#ffffff
    classDef chefNode fill:#ff9a3c,stroke:#b8360f,color:#170c09
    classDef endpoint fill:#2b1510,stroke:#ff5a1f,color:#fff4e0
    class plan,review,ship station
    class chef chefNode
    class idea,done endpoint
Loading

Quick start

/plugin marketplace add ainative-build/skills
/plugin install aif@ainative-build

Then cook something (on the plugin, type : for -, as in /aif:brainstorm):

/aif-brainstorm add rate limiting to the public API
/aif-plan add rate limiting to the public API
/aif-serve .aif/plans/261022-1320-rate-limit
/aif-code-review --pending
/aif-ship

Other runtimes and the skills-only install are under Install.

The menu: skills by station

Every skill has a command, written /aif-<name> throughout these docs. On the Claude Code plugin, plugin commands take a colon, so type /aif:<name> there (for example /aif:plan).

Station Skill What it does
🧭 Shape aif-advise Interviews until the outcome is clear, then gives evidence-backed advice.
aif-brainstorm Turns unclear intent into an accepted outcome and compares approaches.
aif-research Researches technologies, architectures and requirements.
📋 Plan aif-plan Writes phased, test-first plans with acceptance criteria. Also has validate, red-team and archive modes.
🍳 Build aif-serve Implements a plan or feature end to end: tests first, then code, verification and review.
aif-recon Maps the files, callers and tests a task touches.
🩺 Fix aif-debug Proves the root cause of a failure before any fix.
aif-fix Fixes bugs and test, type, lint and CI failures with routed workflows.
🧪 Verify aif-test Designs and runs test suites. Has create, audit and optimize modes.
aif-web-testing Playwright, Vitest and k6 patterns for web apps.
aif-agent-browser Drives a tool-managed browser for snapshots, forms and UI checks.
aif-chrome-profile Drives your real Chrome profile through Chrome DevTools MCP.
🔍 Review aif-code-review Reviews changes, a PR, a commit or the whole codebase, with evidence.
📦 Ship aif-git Conventional commits, branches, PRs and merges, with secret scanning.
aif-ship Takes a finished branch through tests, review, PR, merge and release.
🧠 Think aif-problem-solving Techniques for getting unstuck.
aif-deep-thinking A disciplined reasoning protocol for hard problems.
🎞️ Media aif-ai-multimodal Analyzes and generates images, audio, video and documents.

Test-first, every time

Every plan phase has a Tests First section:

  • characterization tests for behavior that must not change;
  • new-behavior tests, each naming the failure it should show before the code exists;
  • the commands that run the tests red first and green after.

/aif-serve hands that section to aif-test before it writes any production code.

%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#fff1e8', 'primaryTextColor': '#2b1510', 'primaryBorderColor': '#ff5a1f', 'lineColor': '#d9481f', 'secondaryColor': '#ffe2d1', 'tertiaryColor': '#fff8f3', 'clusterBkg': '#fff8f3', 'clusterBorder': '#ff9a3c', 'edgeLabelBackground': '#fff1e8', 'actorBkg': '#fff1e8', 'actorBorder': '#ff5a1f', 'signalColor': '#d9481f', 'noteBkgColor': '#ffe2d1', 'noteBorderColor': '#ff9a3c', 'sequenceNumberColor': '#ffffff'}}}%%
sequenceDiagram
    autonumber
    participant P as Plan phase
    participant S as aif-serve
    participant T as aif-test
    participant C as Code
    P->>S: Tests First section
    S->>T: create, scoped to the phase
    T-->>S: Test files, red output, green command
    Note over S,T: New tests fail on the missing behavior.<br/>Characterization tests pass.
    S->>C: Smallest change that turns them green
    C-->>S: All tests green, gates pass
    S->>C: Refactor with the tests kept green
Loading

A test that fails on an import or setup error isn't red for the right reason, so serve fixes the test before implementing. Pass --no-test to skip all this; serve reports the gap. A phase with nothing testable says Tests First: not applicable and gives the reason.

Everything lands in .aif/

your-project/
└── .aif/
    ├── config.json          optional project settings (docs/aif-config.md)
    ├── plans/
    │   └── 261022-1320-rate-limit/
    │       ├── plan.md      status, phases, acceptance criteria
    │       └── phase-01-….md
    └── reports/             brainstorm, research, debug, review and test reports

User-wide settings live in ~/.aif/config.json, or in $AIF_HOME/config.json when AIF_HOME is set. Local plan state (plans-state.json) sits beside them.

Skills write reports as they run, and /aif-ship commits the reports the shipped work produced. Add .aif/reports/ to .gitignore if you would rather keep them out of git.

One thing lands outside .aif/. The aif agents use Claude Code's project memory (memory: project), so Claude Code keeps their notes in .claude/agent-memory/<agent>/, for example .claude/agent-memory/aif-aif-code-reviewer/. Commit it to share what the agents learn, or ignore it.

Pro-max mode (--pro-max)

--pro-max trades cost for quality on work with a checkable outcome. The skill builds one evidence packet and one scoring rubric and sends them to five independent read-only candidates in parallel. aif-chef, on the strongest model, then scores the five.

%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#fff1e8', 'primaryTextColor': '#2b1510', 'primaryBorderColor': '#ff5a1f', 'lineColor': '#d9481f', 'secondaryColor': '#ffe2d1', 'tertiaryColor': '#fff8f3', 'clusterBkg': '#fff8f3', 'clusterBorder': '#ff9a3c', 'edgeLabelBackground': '#fff1e8', 'actorBkg': '#fff1e8', 'actorBorder': '#ff5a1f', 'signalColor': '#d9481f', 'noteBkgColor': '#ffe2d1', 'noteBorderColor': '#ff9a3c', 'sequenceNumberColor': '#ffffff'}}}%%
flowchart LR
    packet[Evidence packet<br/>+ rubric] --> c1[Candidate 1] & c2[Candidate 2] & c3[Candidate 3] & c4[Candidate 4] & c5[Candidate 5]
    c1 & c2 & c3 & c4 & c5 --> chef{{aif-chef scores}}
    chef -->|most skills| winner[Best candidate,<br/>kept unchanged]
    chef -->|code-review, recon| union[Evidence-checked union<br/>of all findings]

    classDef chefNode fill:#ff9a3c,stroke:#b8360f,color:#170c09
    classDef result fill:#ff5a1f,stroke:#b8360f,color:#ffffff
    class chef chefNode
    class winner,union result
Loading
Rule What it means
Winner selection brainstorm, plan, advise, research, debug, fix, problem-solving and test keep the single best candidate. They never blend candidates, because a blend is not what the verifier checked.
Union code-review and recon keep the deduplicated union of findings that check out against the evidence, so a catch made by only one candidate is not lost.
Fails closed Pro-max needs parallel subagents and stops on a runtime without them. If fewer than five candidates are usable after one retry, or chef rejects them all, nothing is written.
Receipt Each run adds a one-line pro-max: receipt to its report or plan, naming the pick and its margin.

Use it where checking an answer is easier than producing one, such as a plan against acceptance criteria or a review against evidence.

/aif-plan add rate limiting to the public API --pro-max

Chef mode (--chef)

--chef runs a workflow under the supervision of aif-chef, which gives one-shot counsel from the strongest model available. Chef only advises: it never writes code, edits files or overrides a gate. The main agent stays responsible for every decision.

Chef steps in…
After each phase or decision round to check direction before the next one starts
When work is stuck after repeated failures instead of retrying the same fix
Before a high-stakes or irreversible step such as a public-contract change
Once a PR's required checks are green to post its assessment and next steps on the PR
  • --chef is passed on to the next skill in the chain. These skills support it: brainstorm, plan, serve, fix, test, code-review and ship.
  • /aif-plan --chef writes a handover plan that a smaller model can follow, with step-by-step tasks, mechanical pass conditions and a failure protocol that stops and asks chef.
Runtime Chef runs on
Claude Code Fable
Cursor claude-fable-5-high
OMP the @advisor model role
Codex gpt-6-astra. When an account refuses it, chef falls back through gpt-6-sol → gpt-5.6-sol → gpt-6-terra → gpt-5.6-terra → gpt-6-luna → gpt-5.6-luna and says which model answered.
/aif-serve .aif/plans/261022-1320-rate-limit --chef

The crew: agents

Each agent is pinned to a model that fits its job. On Codex, every agent uses the same fallback chain as chef when a model is refused. Full per-runtime models, including OMP and Cursor, are in agents/runtime-models.json.

Agent Job Claude Code Codex
aif-chef One-shot counsel on hard calls; scores pro-max candidates fable gpt-6-astra low
aif-advisor Interview-driven advice fable gpt-6-astra low
aif-planner Researches and writes implementation plans opus gpt-6-sol high
aif-researcher Technical research reports opus gpt-6-sol high
aif-debugger Root-cause investigation opus gpt-6-sol high
aif-code-reviewer Evidence-backed code review opus gpt-6-sol high
aif-fullstack-developer Implements plan phases, including in parallel opus gpt-6-sol high
aif-ui-ux-designer Interface and design work opus gpt-6-sol high
aif-code-simplifier Refines code without changing behavior opus gpt-5.6-luna high
aif-docs-manager Keeps project docs accurate opus gpt-5.6-luna high
aif-tester Runs and checks test suites haiku gpt-5.6-luna medium
aif-recon Finds the files a task touches haiku gpt-5.6-luna low
aif-explore Fast codebase scans haiku gpt-5.6-luna low
aif-git-manager Commits and pushes haiku gpt-5.6-luna low

Rules and hooks

9 rules (rules/) 6 hooks (hooks/)
Development rules Session context: where plans, reports and docs go
Workflow routing and skill routing Subagent context, named for the delegate's reports
Orchestration, with the Codex model fallback Development-rules reminder on each prompt
Documentation management Privacy guard for secrets files
Review, audit and decision rules Scout guard against broad scans
Process management Secret-output reminder
Primary workflow and the hook response protocol

Install

Skills install through skills.sh or the Claude Code plugin. Agents, rules and hooks come with the plugin on Claude Code, and from aif-install everywhere else.

You want Run
Skills only, on any runtime npx skills@latest add ainative-build/skills
Everything on Claude Code /plugin marketplace add ainative-build/skills, then /plugin install aif@ainative-build
Agents, rules and hooks without the plugin npx -p github:ainative-build/skills aif-install --runtime codex
  • --runtime takes claude, codex, omp, cursor or all.
  • --dry-run lists the files first, and --uninstall removes everything the installer added.
  • Safe edits: the installer backs up each file it edits and never touches entries it did not write. It records what it owns in ~/.aif/install-manifest.json.
  • Claude Code: use either the plugin or aif-install --runtime claude, not both, because both register the same hooks.
  • Codex: it runs new hooks only after you approve them, so start codex once after installing and approve the aif hooks.

Runtime support

Claude Code Codex OMP Cursor
Skills ✅ ✅ ✅ ✅
Agents ✅ ✅ TOML ✅ model roles ✅
Rules ✅ ✅ inlined in AGENTS.md ✅ ✅ .mdc
Context hooks ✅ ✅ — session start only
Privacy and scout guards ✅ ✅ — ✅ via cursor-adapter.cjs

OMP has no hooks. Cursor can't add context when a prompt is submitted or a subagent starts, so it gets the rules through .mdc files instead of the reminder hook.

Configuration

Plans, reports, language and per-hook switches live in an optional .aif/config.json. See docs/aif-config.md.

Upgrading

From v2.1 to v2.2

No breaking changes. Rerun aif-install (or update the plugin) to pick up:

  • Test-first stubs: /aif-test create writes signature-only stubs so red tests fail on assertions. /aif-serve and /aif-fix call it rather than writing tests themselves.
  • Local ship: in a repo with no remote, /aif-ship skips issues, fetch, push and the PR, never calls gh, and stops with the branch ready. It merges locally only with --merge.
  • Branch review: /aif-code-review --base [ref] reviews a local branch against its target. Pending mode includes untracked files, and neither mode asks questions in a headless run.
  • Plan state follows AIF_HOME: it lives at $AIF_HOME/plans-state.json, else ~/.aif/plans-state.json.
  • Scout-block keeps blocking, and its message now tells the agent not to work around it.
  • Ship commits reports: the .aif/reports/ files from the branch's aif steps are committed at ship time.
From v2.0 to v2.1 (breaking)
  • Journal removed:
    • The aif-journal skill, the aif-journal-writer agent and /aif-journal are gone.
    • Rerunning aif-install removes the old agent.
    • A skills.sh install leaves the old skill in place; remove it with npx skills remove -g aif-journal.
  • Output moves to .aif/:
    • Plans go to .aif/plans/ and reports to .aif/reports/.
    • Config moves to .aif/config.json, and user config to ~/.aif/config.json.
    • .aif.json, ~/.aif.json and the journal.* settings are no longer read, so move existing plans and config by hand.
  • Test-first by default: every plan phase has a Tests First section, and /aif-serve writes failing tests before it implements. The --tdd flag is removed.
From v1 to v2 (breaking)
  • Replaced:
    • The v1 skills aif-code-review, aif-recon and aif-improve are replaced, along with the v1 code-reviewer agent.
    • aif-code-review and aif-recon are new skills under the same names.
    • aif-improve is gone.
  • skills.sh: an install of v2 updates aif-code-review and aif-recon but leaves the old aif-improve in place. Remove it with npx skills remove -g aif-improve.
  • Still available: the v1 tree is at the v1.3.1 tag.

Talk deck

docs/deck/index.html is the deck for the talk Multiply your productivity in a nutshell: seven mental models for working with coding agents, then the system we run, from harness to AI Factory. It is one self-contained file; download it and open it in a browser. The arrow keys move between slides, N shows the speaker notes and F goes full screen.

License

MIT © 2026 ainative-build; see LICENSE. These parts keep their own licenses:

  • skills/engineering/aif-agent-browser/ and skills/engineering/aif-web-testing/ are licensed under Apache-2.0; the full text is in each directory's LICENSE. They were modified for this repo: renamed to aif-*, with references to removed skills and runtime metadata deleted.
  • skills/engineering/aif-chrome-profile/ is MIT, Copyright (c) 2026 chrome-profile-cdp contributors; see that directory's LICENSE.
  • hooks/scout-block/third-party/ignore.cjs is ignore v5.3.0, MIT, Copyright (c) 2013 Kael Zhang.
Rendered by GitHub from the repository’s README. Scroll to read the full file.

First trending

Jul 23, 2026

first spotted on the list

Best rank

#45

highest position reached

Appearances

1

times on the trending list

Star velocity

0.05

stars per day since creation

Activity — last 60 days

daily counts, collected every 6 hours
  • Stars
  • Forks
  • Merged PRs
  • Issues
  • Closed issues

Collecting activity data since launch — check back in a few days.

Star history

total stars per snapshot

Not enough snapshots yet — check back soon.

Rank history

position on trending · lower is better

Not enough snapshots yet — check back soon.

3D card for your website

Live HTML card with a pointer tilt. Paste the iframe on any website.

<iframe src="https://www.notionpulse.cc/embed/ainative-build/skills" width="420" height="240" style="border:0;max-width:100%;background:transparent" loading="lazy" title="ainative-build/skills — trending on Open Source Pulse"></iframe>

Stars badge

Show current stars in your README or profile. Auto-updates every 6 hours.

ainative-build/skills stars badge
Markdown
[![ainative-build/skills](https://www.notionpulse.cc/api/badge/ainative-build/skills.svg)](https://www.notionpulse.cc/repo/ainative-build/skills)
HTML
<a href="https://www.notionpulse.cc/repo/ainative-build/skills"><img src="https://www.notionpulse.cc/api/badge/ainative-build/skills.svg" alt="ainative-build/skills stars badge" /></a>

Repository of the Day

#45 Repository of the Day

Repository of the Week

#45 Repository of the Week

Repository of the Month

#45 Repository of the Month