ClaudeMap

cli-faq-shortcuts

Mines your own Claude Code and Codex history for the asks you keep retyping and turns each one into a project shortcut like /sent or /project billing.

Skills & Commandsagent-skillshortcutshistory-miningproductivity
Visit projectkishormorol/cli-faq-shortcuts

An Agent Skill (repo: cli-faq-shortcuts, skill: faq-shortcuts) that reads your local session history, groups paraphrased repeats by intent, and writes the picks as tiny per-project skills at .claude/skills/<name>/SKILL.md — each with trigger descriptions, the exact command to run, and the traps to avoid. In one real project cited in the README, the most-repeated ask had been typed 127 times while its closest exact repeat appeared only 4 times, which is why the grouping is the agent's job. The Python extractor also runs standalone for raw counts (nothing leaves your machine), and the /faq-shortcuts command supports --since and --source codex filters. Works in Claude Code, Codex and Cursor; needs git and Python 3.9+. Apache-2.0.

What it does

  • Finds intent-level repeats, not just exact matches — paraphrased asks group together (the sample project's top ask was typed 127 times; its closest exact repeat, 4)
  • Each pick becomes a versioned project skill: .claude/skills/<name>/SKILL.md with trigger description, the query command and known traps
  • Extractor runs standalone for raw counts — no agent needed, nothing leaves your machine
  • --since and --source codex filters scope the mining to recent or per-harness history

When to use it

Anyone who notices they retype the same weekly signups check, newsletter-status question or billing-blocker ask — the shortcut encodes the question once, with the guardrails (“report only, never re-send”) written where the agent will read them.

Getting started

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

# needs git and Python 3.9+; then in your project:
#   /faq-shortcuts              (or just ask: what do I keep asking in this project?)

Things to know

Shortcut quality is yours to review: the generated SKILL.md files are plain markdown — check the query command and the guardrails before trusting them. Grouping quality depends on the model, and the standalone counter only counts exact repeats (it undercounts by design). macOS/Linux documented in the README's main flow, with a separate Windows section. Apache-2.0.

Repository

kishormorol/cli-faq-shortcuts

Charted

Related on the map

  • guizang-product-video-skill

    Skill

    Guizang's agent skill turns your repo's recent updates into a finished promo video — real components, code-rendered animation, an original code-written soundtrack — no video editor involved.

    • agent-skill
    • video
    • promo
    • marketing
    View

  • geo-sleuth

    Skill

    An agent skill that geolocates a photo with nothing readable in it — OSM geometry, elevation skylines and satellite tiles turn “where was this taken?” into a measured answer with an error radius.

    • agent-skill
    • geolocation
    • osint
    • openstreetmap
    View

  • Birdview

    Skill

    A skill that makes AI coding agents map the architecture and declare the blast radius before they touch a line of code — rendered as one standalone HTML page.

    • skill
    • architecture
    • code-visualization
    • change-scope
    View