Learn-skills.dev cli
Route terminal work to the narrowest CLI instead of generic shell patterns. Use this skill when the user asks to search with `rg` or `fd`, rewrite text with `sd`, `comby`, or `ast-grep`, inspect output with `head` or `less`, fetch files with `wget`, transform JSON or YAML with `jq` or `yq`, pick items with `fzf`, compare code with `difftastic`, lint shell with `shellcheck`, or measure a repo with `scc`.
install
source · Clone the upstream repo
git clone https://github.com/NeverSight/learn-skills.dev
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/NeverSight/learn-skills.dev "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/skills-md/aaronflorey/agent-skills/cli" ~/.claude/skills/neversight-learn-skills-dev-cli && rm -rf "$T"
manifest:
data/skills-md/aaronflorey/agent-skills/cli/SKILL.mdsource content
CLI Router
Route the task to the narrowest tool that matches the job. Keep this file small; read
references/ only for the tool you need.
Choose The Tool
| Tool | Use it for | Avoid when | Reference |
|---|---|---|---|
| Fast file and path discovery | You need content matches inside files | |
| Fast text search across files | You need structural or syntax-aware matching | |
| Simple literal or regex replacement | The change depends on code structure or multiline context beyond regex comfort | |
| Lightweight structural rewrites across languages | You need full syntax parsing guarantees | |
| AST-aware code search, lint, and rewrite | You need type-aware or semantic analysis | |
| Query and transform JSON | The source is YAML-first | |
| Query and edit YAML, convert structured formats | You need exact comment preservation or full parity assumptions | |
| Non-interactive download, retry, resume, mirror | You need browser automation or interactive login flows | |
| Quick non-interactive sampling | You need interactive search, paging, or follow mode | |
| Interactive paging, search, and follow | The flow must stay unattended | |
| Interactive fuzzy selection for humans | The agent must run headless or deterministically | |
| Syntax-aware diffs for human review | You need an applicable patch or machine-stable diff format | |
| Shell linting and safety checks | You need formatting rather than diagnostics | |
| Repo language inventory, LOC, and rough complexity | You need semantic code review or profiling | |
Escalate Deliberately
- Use
for paths, thenfd
for text.rg - Use
for simple replacements,sd
when regex gets brittle, andcomby
when syntax precision matters.ast-grep - Use
for JSON andjq
for YAML-first edits or format conversion.yq - Use
for quick samples; switch tohead
only when a human needs to page or search.less - Treat
,fzf
, andless
as human-oriented tools unless the task explicitly benefits from interactive review.difftastic
Load More Detail Only When Needed
- Read
for command/flag selection across the toolset.references/api-surface.md - Read
for ready-made task patterns.references/common-use-cases.md - Read
for common failure modes.references/troubleshooting-workarounds.md - Read the tool-specific reference for examples, sharp edges, and escalation boundaries.