cli-faq-shortcuts

Stop typing the same long request to your coding agent every day. This
Agent Skill reads your own history, finds the asks you keep
repeating, and turns each one into a short command, like /sent or /project billing.
It works in Claude Code, Codex and Cursor.

Quick start

1. Install (macOS / Linux, needs git and Python 3.9+):

git clone https://github.com/kishormorol/cli-faq-shortcuts ~/.agents/skills/faq-shortcuts
mkdir -p ~/.claude/skills && ln -sfn ~/.agents/skills/faq-shortcuts ~/.claude/skills/faq-shortcuts

2. Open your project in Claude Code, Codex or Cursor, in a new session.

3. Ask "what do I keep asking in this project?", or type /faq-shortcuts in Claude Code.

You'll get a table of your most repeated asks with how often you typed each. Pick the
ones you want and they become shortcuts in that project.

The repo is cli-faq-shortcuts; the skill it installs is called faq-shortcuts.

If it saves you typing, please ⭐ star the repo. Stars are how other people find it.

Commands

# inside your project, in Claude Code
/faq-shortcuts                        # find your repeated asks and propose shortcuts
/faq-shortcuts --since 2026-06-01     # only look at recent history
/faq-shortcuts --source codex         # only what you asked Codex

# the extractor on its own: no agent, nothing leaves your machine
E=~/.agents/skills/faq-shortcuts/scripts/extract_asks.py
python3 $E .                          # every prompt you typed here, oldest first
python3 $E . --since 2026-09-01 | wc -l                  # how many since September
python3 $E . | awk -F'\t' 'split($3,w," ")>=4 {print tolower($3)}' \
  | sort | uniq -c | sort -rn | head                     # your most repeated exact requests

The last one counts exact repeats only, and it undercounts. On one real project, the most
repeated exact request appeared 4 times. Grouped by intent, however it was worded, the top
ask had been typed 127 times. That grouping is the agent's job in /faq-shortcuts.

What you get

Each shortcut is a small file in your project, .claude/skills/<name>/SKILL.md, for example:

---
name: sent
description: Check whether a batch email actually reached people. Use for "did the
  newsletter go out?", "did it reach everyone?", "did X get the email?".
---
# Did it go out

Report only. Never re-send from this shortcut.

## Query
scripts/email-status.js --batch <name>   ← the script your project already has

## Traps
- A "delivered" status to a shared inbox proves nobody read it (happened 3 May).

## Report
Sent / delivered / bounced counts, then the bounced addresses. Then ask.

The shortcuts point at the scripts and queries your project already uses, and they
record the mistakes already made on that path. So a shortcut is shorter to type and safer
to run. Anything that writes or sends does a dry run first and waits for your yes, so a
typo stops at the preview.

How it works

1. Collect. scripts/extract_asks.py prints every prompt you typed in the project,
   from Claude Code and Codex history. It skips subagent turns and scripted runs, because
   you didn't type those.
2. Cluster. The agent groups prompts by intent, whatever the wording, and counts them.
3. Check. It looks for shortcuts you already have and the tools your project already has.
4. Propose. You get a table of shortcut, the ask it replaces, and how often you asked.
   You pick.
5. Write. Each chosen shortcut becomes a SKILL.md in .claude/skills/, linked into
   .agents/skills/ so all three agents load it, committed so your team gets it too.
6. List. A table in CLAUDE.md / AGENTS.md maps each shortcut to the sentence it replaces.

Install

The quick start above is the whole install. It puts the skill where each agent looks:

Update: git -C ~/.agents/skills/faq-shortcuts pull

Uninstall: rm ~/.claude/skills/faq-shortcuts && rm -rf ~/.agents/skills/faq-shortcuts

Windows: run the commands in WSL, or copy the folder into both locations instead of
linking it.

What it reads

To see what it finds without the agent:

python3 ~/.agents/skills/faq-shortcuts/scripts/extract_asks.py ~/my-project | head

This prints date<TAB>source<TAB>prompt. Add --source claude or --source codex to read
one tool only, and --since 2026-01-01 to skip older prompts.

Troubleshooting

Contributing

Issues and pull requests are welcome. Good first contributions:

• Windows support without WSL: the install relies on symlinks.
• Reading Cursor history, so Cursor users' asks are counted too.
• A bug report with the extractor command you ran and what it printed.

Everyone whose pull request is merged appears here:

Built with help from Claude Code.

Privacy

The extractor only reads local files and makes no network calls. Your prompts can contain
names, emails and tokens, so the skill writes the list to a scratch folder, never into
your repo. Your agent then reads that list the same way it reads any file you show it.

License

Apache-2.0.