README.md

Agent skills for the JavaScript and TypeScript codebase intelligence layer.

Agent skills for fallow, Rust-native codebase intelligence for JavaScript and TypeScript. The free static layer reports quality, changed-code risk, cleanup opportunities, circular dependencies, code duplication, complexity hotspots, and architecture boundary violations in milliseconds. The optional paid runtime layer (Fallow Runtime) adds production execution evidence so agents can delete cold code, flag hot-path changes, and retire stale flags with proof. 118 framework plugins, zero configuration. Works with any agent that supports the Agent Skills specification: Claude Code, Cursor, OpenAI Codex, Windsurf, GitHub Copilot, Gemini CLI, Amp, and 30+ more.

Linters enforce style. Formatters enforce consistency. Fallow enforces relevance. Linters work file by file. TypeScript works type by type. Neither builds the full module graph, so neither can see what nothing depends on. Fallow does, in milliseconds. These skills teach agents how to use fallow effectively: which commands to run, what flags to use, how to interpret output, and how to avoid common pitfalls.

Quick Start

Agent Skills CLI

npx skills add fallow-rs/fallow-skills

Claude Code

/install fallow-rs/fallow-skills

Agent-specific CLI shortcuts

npx skills add fallow-rs/fallow-skills --agent windsurf
npx skills add fallow-rs/fallow-skills --agent amp
gemini skills install https://github.com/fallow-rs/fallow-skills.git

Manual install

tmp=$(mktemp -d)
git clone https://github.com/fallow-rs/fallow-skills.git "$tmp/fallow-skills"

Copy the fallow skill directory into your agent's skills folder:

# OpenAI Codex, Amp, and agents using the shared Agent Skills location
mkdir -p ~/.agents/skills
cp -R "$tmp/fallow-skills/fallow/skills/fallow" ~/.agents/skills/fallow

# Claude Code
mkdir -p ~/.claude/skills
cp -R "$tmp/fallow-skills/fallow/skills/fallow" ~/.claude/skills/fallow

# Cursor
mkdir -p ~/.cursor/skills
cp -R "$tmp/fallow-skills/fallow/skills/fallow" ~/.cursor/skills/fallow

# Windsurf
mkdir -p ~/.codeium/windsurf/skills
cp -R "$tmp/fallow-skills/fallow/skills/fallow" ~/.codeium/windsurf/skills/fallow

# GitHub Copilot
mkdir -p .github/skills
cp -R "$tmp/fallow-skills/fallow/skills/fallow" .github/skills/fallow

Other agents

Use npx skills add fallow-rs/fallow-skills --all for installer-managed discovery, or copy fallow/skills/fallow into your agent's skills location as fallow. This skill follows the open Agent Skills specification and works with any compatible agent.

Prerequisites

Fallow must be installed in the target project:

npm install -g fallow    # prebuilt binaries
npx fallow                   # or run without installing

See the installation guide for all options including cargo install fallow-cli.

Available Skills

Skill	Description	Trigger phrases
fallow	Codebase intelligence for JS/TS: quality, changed-code risk, cleanup opportunities, circular deps, duplication, complexity, and (with Runtime) hot-path and cold-path evidence	"check code health", "audit this PR", "find cleanup opportunities", "find duplicates", "what code actually runs"

What's Included

fallow

Category	What it does
Cleanup	Find unused files, exports, types, dependencies, enum/class members, stale suppressions, and other safe cleanup candidates
Duplication	Find code clones with 4 modes: strict, mild, weak, semantic
Complexity	Function complexity analysis, hotspot detection, health scores
Auto-Fix	Remove unused exports and dependencies with dry-run preview
CI	GitHub Actions, SARIF upload, baseline comparison, PR-scoped checks
Monorepo	Per-workspace analysis with cross-package resolution
Debug	Trace export usage chains, file edges, and dependency usage

Reference Documentation

• CLI Reference: all 10 commands, flags, JSON output structure, config format
• Gotchas: 19 pitfalls with WRONG/CORRECT examples
• Patterns: 14 workflow recipes for CI, monorepos, migration, incremental adoption

Example Prompts

Once installed, you can use natural language:

• "Audit the codebase quality"
• "Are there any unused dependencies?"
• "Find code duplication in the codebase"
• "Clean up unused exports"
• "Set up a CI quality gate"
• "Check the complexity of this codebase"
• "Why is this export flagged as unused?"
• "Check if this PR introduces quality risk"
• "Find unused files in the payments package"
• "What's the duplication percentage?"

How It Works

User: "Find all unused exports"
  ↓
Agent loads fallow skill
  ↓
Skill instructs: run `fallow dead-code --format json --quiet --unused-exports`
  ↓
Agent executes command, parses JSON output
  ↓
Agent summarizes findings with file paths and line numbers

The skill provides agents with:

1. Command knowledge: which fallow command + flags to use for each task
2. Output parsing: how to interpret JSON results
3. Guardrails: always dry-run before fix, never run watch, use --yes in non-TTY
4. Debugging: how to trace false positives with --trace

Contributing

See CLAUDE.md for repository structure, skill creation guidelines, and quality standards.

Related

• fallow: Rust-native codebase intelligence for JavaScript and TypeScript, a single-pass alternative to knip and jscpd
• fallow-docs: Official documentation
• VS Code extension: Real-time diagnostics in your editor
• Agent Skills specification: The open standard this skill follows

License

MIT. See LICENSE for details.