fallow-skills
Health Warn
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 6 GitHub stars
Code Pass
- Code scan — Scanned 5 files during light audit, no dangerous patterns found
Permissions Pass
- Permissions — No dangerous permissions requested
This is a skill pack that teaches AI coding assistants (like Claude Code, Cursor, and Gemini CLI) how to run and interpret analyses for the Fallow codebase analyzer. It provides agents with instructions on how to find unused code, circular dependencies, and complexity hotspots in JavaScript and TypeScript projects.
Security Assessment
The overall risk is Low. The automated code scan reviewed 5 files and found no dangerous patterns, no hardcoded secrets, and no dangerous permissions requested. The tool is essentially a set of instructional files and manifests for AI agents rather than a standalone executable application. It does not appear to access sensitive data, make external network requests, or execute malicious background shell commands.
Quality Assessment
The project appears to be actively maintained, with its last push occurring today. It uses the highly permissive MIT license, which is standard for open-source development tools. The primary drawback is its extremely low community visibility. Having only 6 GitHub stars indicates a very small user base, meaning the tool has not been extensively battle-tested or broadly reviewed by the developer community yet. However, the repository is well-documented and clearly outlines its setup and intended use cases.
Verdict
Safe to use, though developers should keep in mind that the project currently has low community visibility and limited public vetting.
Agent skills for the JavaScript codebase analyzer. Teaches AI agents how to find unused code, circular deps, duplication, and complexity with fallow. Works with Claude Code, Cursor, Codex, Gemini CLI, and 30+ agents.
Agent skills for the JavaScript and TypeScript codebase analyzer.
Agent skills for fallow, the Rust-native codebase analyzer for JavaScript and TypeScript. Fallow finds unused code, circular dependencies, code duplication, complexity hotspots, and architecture boundary violations. 84 framework plugins, zero configuration, sub-second performance. 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
Claude Code
/install fallow-rs/fallow-skills
Cursor
git clone https://github.com/fallow-rs/fallow-skills.git ~/.cursor/skills/fallow-skills
OpenAI Codex
git clone https://github.com/fallow-rs/fallow-skills.git ~/.agents/skills/fallow-skills
Windsurf
git clone https://github.com/fallow-rs/fallow-skills.git ~/.codeium/windsurf/skills/fallow-skills
GitHub Copilot
git clone https://github.com/fallow-rs/fallow-skills.git .github/skills/fallow-skills
Gemini CLI
gemini skills install https://github.com/fallow-rs/fallow-skills.git
Amp
git clone https://github.com/fallow-rs/fallow-skills.git ~/.config/agents/skills/fallow-skills
Other agents
Clone or copy the skill directory into your agent's skills location. 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 dead-code # or run without installing
See the installation guide for all options including cargo install fallow-cli.
Available Skills
| Skill | Description | Trigger phrases |
|---|---|---|
| fallow | Codebase analysis for JS/TS: unused code, circular deps, duplication, complexity | "find dead code", "unused exports", "find duplicates", "check code health" |
What's Included
fallow
| Category | What it does |
|---|---|
| Dead Code | Find unused files, exports, types, dependencies, enum/class members (15 issue types) |
| 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:
- "Find all dead code in this project"
- "Are there any unused dependencies?"
- "Find code duplication in the codebase"
- "Clean up unused exports"
- "Set up a CI check for dead code"
- "Check the complexity of this codebase"
- "Why is this export flagged as unused?"
- "Check if this PR introduces dead code"
- "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:
- Command knowledge: which fallow command + flags to use for each task
- Output parsing: how to interpret JSON results
- Guardrails: always dry-run before fix, never run watch, use
--yesin non-TTY - Debugging: how to trace false positives with
--trace
Contributing
See CLAUDE.md for repository structure, skill creation guidelines, and quality standards.
Related
- fallow: The Rust-native codebase analyzer for JavaScript (3-36x faster than knip)
- 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.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found