fallow-codex-onboarding — Claude Code skill: setup and configuration
The fallow-codex-onboarding skill for Claude Code automates the initial onboarding for the Fallow analysis system. It verifies CLI presence, configures analysis scopes, and performs the first project scan.
MIT 125 installs ★ 141 updated 2026-10-24
npx skills add fallow-rs/fallow-skills --skill fallow-codex-onboarding -a claude-codeWhat fallow-codex-onboarding does
The tool assists with deploying Fallow immediately after installing the plugin. Upon activation, the agent calls fallow_check_install to verify the version; if the CLI is missing, it offers a global installation using npm install --global fallow.
Following installation, the agent manages settings via fallow_settings_read and fallow_settings_update, querying preferences regarding analysis scope and exclusions for test or dev tooling. Once configured, the skill runs fallow_analyze, presents the health score, and points out key integration areas like the dashboard, Code Health tab, @Fallow mentions, and the .fallowrc.json configuration file.
What it helps with
- perform an initial codebase audit
- configure project analysis scope
- setup project rule configuration files
- install missing Fallow dependencies
Example prompts for the agent
- Set up Fallow for this project
- Onboard Fallow app
- Configure Fallow settings
How to install fallow-codex-onboarding
1Skills CLI (Vercel)
npx skills add fallow-rs/fallow-skills --skill fallow-codex-onboarding -a claude-code2Manually: put the files in place
~/.claude/skills/fallow-codex-onboarding/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/fallow-codex-onboarding/
1Skills CLI (Vercel)
npx skills add fallow-rs/fallow-skills --skill fallow-codex-onboarding -a codex2Manually: put the files in place
.agents/skills/fallow-codex-onboarding/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add fallow-rs/fallow-skills --skill fallow-codex-onboarding -a cursor2Manually: put the files in place
.cursor/skills/fallow-codex-onboarding/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install fallow-rs/fallow-skills fallow/skills/fallow-codex-onboarding2Manually: put the files in place
.github/skills/fallow-codex-onboarding/SKILL.md1Skills CLI (Vercel)
npx skills add fallow-rs/fallow-skills --skill fallow-codex-onboarding -a gemini-cli2Platform CLI
gemini skills install https://github.com/fallow-rs/fallow-skills --path fallow/skills/fallow-codex-onboardingManually: put the files in place
.devin/skills/fallow-codex-onboarding/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add fallow-rs/fallow-skills --skill fallow-codex-onboarding -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about fallow-codex-onboarding
How to install fallow-codex-onboarding in Claude Code?
Run npx skills add fallow-rs/fallow-skills --skill fallow-codex-onboarding -a claude-code.
What does this skill do?
It streamlines the Fallow setup process by validating the CLI environment, updating user preferences, and executing the first analysis to display relevant health findings.
What is required to run fallow-codex-onboarding?
You need the fallow CLI available in your PATH for the sidebar dashboard to function, plus a Node.js environment.
Source text
SKILL.md · MIT
---
name: fallow-codex-onboarding
description: >-
Set up the Fallow app in Codex after the plugin is installed: check the
fallow installation, choose the default analysis scope, run the first
analysis, and show the user where the dashboard, the Code Health tab,
@Fallow mentions and the config editor are. Use when the user chooses Set
up for Fallow in Codex, or asks to onboard or configure the Fallow app.
Do not use for setting up lint, format or CI tooling; use fallow-setup for
that.
---
# Set up Fallow in Codex
Use the Fallow app tools. Keep each step short. Ask one question at a time.
## 1. Check the installation
Call `fallow_check_install` with `{}`.
- If it reports a version, continue.
- If fallow is missing, explain that the app runs the fallow CLI locally and
that no code leaves the machine. Offer to install it globally with
`npm install --global fallow`. The sidebar dashboard needs a fallow on PATH,
because the app runs a copy inside the project only within the Codex sandbox
of a thread. Run the install only after the user agrees. Then call
`fallow_check_install` again.
## 2. Choose the defaults
Call `fallow_settings_read` with `{}`. Ask these questions, one at a time.
Skip a question when the user already answered it.
1. "Analyze the whole project by default, or only the files your branch
changed?" Map the whole project to `scope: "full"` and changed files to
`scope: "changed"`.
2. "Leave tests, stories and dev tooling out of the analysis?" Map yes to
`production: true`.
Call `fallow_settings_update` with a `set` object that holds only the changed
values, for example `{"set":{"scope":"changed"}}`. Skip the call when nothing
changed. Report the saved values from the tool result. Do not say that a value
was saved when the call failed.
## 3. Run the first analysis
Call `fallow_analyze` with `{}`. The user sees the dashboard. In two or three
sentences, give the health score, the largest category of findings, and one
finding to start with.
If the result says that no project is known, ask the user to open a project
folder in this thread, then call `fallow_analyze` again.
## 4. Show what the app adds
Tell the user, in a short list:
- **Fallow** in the sidebar opens the full dashboard.
- **Code Health** opens beside a thread and follows the project of that thread.
- Type **@Fallow** in the composer to attach a finding or all findings of a rule.
- Open `.fallowrc.json` or `.fallowrc.jsonc` to edit rules and preview their
impact before saving. `.sarif` files open in a findings viewer.
- Before a commit, ask Codex to audit the branch.
## 5. Offer the next step
If the project has no fallow config file (`.fallowrc.json`, `.fallowrc.jsonc`,
`fallow.toml` or `.fallow.toml`), offer the `fallow-setup` skill to add one and
a CI gate. If the user installed the plugin during another task, continue that
task in this conversation.
© fallow-rs · MIT · fallow-rs/fallow-skills