Sandbox
@fallow-rs/fallow-skills

Fallow skills for Claude Code, Codex, and other agents

This repository packages Agent Skills that teach builders how to use fallow for JavaScript and TypeScript codebase intelligence. The skills cover quality checks, changed-code risk, cleanup opportunities, duplicates, circular dependencies, complexity, architecture drift, and runtime evidence when Fallow Runtime is available.

121 stars9 forksJavaScriptUpdated 7d ago
Who it's for

Builders who want their agent to inspect a JavaScript or TypeScript codebase with fallow and act on structural issues.

What it delivers

You can ask your agent to find dead code, risky changes, and drift in milliseconds instead of reading the whole graph by hand.

What it does

Codebase intelligence skills

The `fallow` skill covers quality, changed-code risk, cleanup opportunities, circular dependencies, duplication, complexity, design-system drift, and runtime evidence.

Review-focused skill

The `fallow-review` skill helps with changed-code risk, blast radius, and structural decisions during branch and PR review.

Agent-specific install paths

The README shows install flows for Claude Code, Codex, Windsurf, Gemini CLI, and general Agent Skills installers.

Statusline support

Claude Code users can add the Fallow Impact statusline segment with `/fallow:impact-statusline setup user compose`.

Reference docs and gotchas

The repo includes CLI reference, gotchas, and workflow patterns for CI, monorepos, migration, and incremental adoption.

Validation and release tooling

Scripts check skill frontmatter, source contracts, and packaging/release behavior.

How to get it

  1. 1Run
    npx skills add fallow-rs/fallow-skills
  2. 2Run
    /plugin marketplace add fallow-rs/fallow-skills
    /plugin install fallow@fallow-skills
  3. 3Run
    codex plugin marketplace add fallow-rs/fallow-skills
    codex plugin add fallow@fallow-skills
  4. 4Claude Code users can add the compact Fallow Impact segment to their statusline
    /fallow:impact-statusline setup user compose
  5. 5Run
    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

README

fallowfallow
Agent skills for the fallow codebase intelligence layer for TypeScript and JavaScript.

MIT License CI Agent Skills fallow v3.24.1

Agent skills for fallow, codebase intelligence for TypeScript and JavaScript. The static layer reports quality, changed-code risk, cleanup opportunities, circular dependencies, code duplication, complexity hotspots, architecture boundary violations, and design-system styling drift in milliseconds. Optional runtime intelligence adds production execution evidence so agents can delete cold code, flag hot-path changes, and retire stale flags with proof. Broad framework plugin coverage, 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. See Fallow for coding agents for the visual overview and store links.

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

/plugin marketplace add fallow-rs/fallow-skills
/plugin install fallow@fallow-skills

OpenAI Codex

codex plugin marketplace add fallow-rs/fallow-skills
codex plugin add fallow@fallow-skills

Fallow Impact statusline

Claude Code users can add the compact Fallow Impact segment to their statusline:

/fallow:impact-statusline setup user compose

The command doc covers status, remove, and the project scope. Other agents render the same line with fallow impact statusline.

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
Other agents

Use npx skills add fallow-rs/fallow-skills --all for installer-managed discovery, or copy the directories under fallow/skills/ into your agent's skills location.

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.

Privacy and network behavior

Analysis runs locally by default and telemetry is off unless the user opts in. The plugin README lists the exact network, telemetry, and statusline behavior for the Claude Code and Codex surfaces.

Available Skills

SkillDescriptionTrigger phrases
fallowCodebase intelligence for JS and TS, code and styles: quality, changed-code risk, cleanup opportunities, circular deps, duplication, complexity, design-system drift, and runtime evidence"check code health", "audit this PR", "find cleanup opportunities", "find duplicates", "what code actually runs"
fallow-reviewGraph-grounded review of changed-code risk, blast radius, and consequential structural decisions"review this branch", "review this PR", "check changed code before merge"

Reference Documentation

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

Contributing

See AGENTS.md for repository structure and quality standards. The fallow skill is vendored byte-for-byte from the fallow source repository at the commit pinned in source-lock.json; CI checks that pin against a clean source checkout and rejects contract or privacy-boundary drift. Maintainers can find the versioning, packaging, and store update procedure in RELEASING.md.

Enable the commit hook

A fresh clone runs no hooks. Turn them on once per clone:

git config core.hooksPath .githooks

The hook only checks manifest version agreement and the bump rule; see .githooks/pre-commit for why it stops there.

Related

License

MIT. See LICENSE for details.

Files in the repo

Repository payload15 top-level entries
  • .agents
  • .claude-plugin
  • .githooks
  • .github
  • fallow
  • scripts
  • .gitignore
  • AGENTS.md
  • CHANGELOG.md
  • CLAUDE.md
  • context7.json
  • LICENSE
  • README.md
  • RELEASING.md
  • source-lock.json

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More skills

obra/
superpowers

An agentic skills framework & software development methodology that works.

285k
1 add

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

117k
1 add
Vincentwei1021/
anything2explainer

Topic in, narrated explainer video out. A Claude Code / Codex skill that turns any topic into a black-canvas motion-graphics explainer video with TTS voiceover, subtitles and a chapter progress bar. Chinese or English; every frame drawn in code with Remotion.

666

Open-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)

71k