Agent skill

Faq Shortcuts

by kishormorol in kishormorol/cli-faq-shortcuts

Turn the questions and instructions a user keeps typing into a project into short slash-command skills, mined from their real Claude Code, Codex and Cursor session history and git log.

Apache-2.0Auto-check passedSales & Support

Install Faq Shortcuts

skills CLI
$ npx skills add kishormorol/cli-faq-shortcuts --skill faq-shortcuts -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install kishormorol/cli-faq-shortcuts faq-shortcuts --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
faq-shortcuts
GitHub stars
127
Token cost
~1.4k tokens
SKILL.md length
692 words
Files
23 (incl. scripts)
Skills in repo
1
Repo updated
First seen
Licence
Apache-2.0

At a glance

Turn the questions and instructions a user keeps typing into a project into short slash-command skills, mined from their real Claude Code, Codex and Cursor session history and git log.

  • Works in 6 steps: Collect the asks → Cluster by intent, then count → Check what already exists → …
  • The user says they ask the same things every day
  • SKILL.md covers 1. Collect the asks, 2. Cluster by intent, then count, 3. Check what already exists and 4. Propose before writing, plus 3 more sections
  • Calls codex, python3 and claude

What it does

Faq Shortcuts is an agent skill from kishormorol/cli-faq-shortcuts. Turn the questions and instructions a user keeps typing into a project into short slash-command skills, mined from their real Claude Code, Codex and Cursor session history and git log. The shortcuts load in Claude Code, Codex and Cursor. Use when the user says they ask the same things every day, wants an FAQ or shortcuts or abbreviations for a project, wants to "stop writing the whole command", or asks what they repeat most.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 28 other files, including scripts (for example `.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json` and `.github/ISSUE_TEMPLATE/bug_report.yml`).

It sits in Sales & Support, covering Help center and FAQ content and Hooks and plugins. It works with Git and Python. The repository describes itself as: Turn repeated Claude Code, Codex, and Cursor prompts into reusable slash commands. Local Python history extractor + Agent Skill. The licence is Apache-2.0.

When your agent uses it

  • The user says they ask the same things every day
  • Abbreviations for a project
  • Wants to stop writing the whole command
  • Asks what they repeat most

Example prompts

  • “stop writing the whole command”
  • “/faq-shortcuts”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Collect the asks
  2. Cluster by intent, then count
  3. Check what already exists
  4. Propose before writing
  5. Write each skill
  6. Make them findable

What it can do on your machine

Read from SKILL.md and the folder at commit 056c5aa. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • codex
    • python3
    • claude
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Faq Shortcuts loads about 1.4k tokens when it runs. Until then it costs about 111 tokens; SKILL.md has 692 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~111
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from kishormorol/cli-faq-shortcuts at commit 056c5aa, republished under its Apache-2.0 licence (© kishormorol). 692 words, ~1,410 tokens.

Download SKILL.mdSave it as .claude/skills/faq-shortcuts/SKILL.md (or your agent's skills folder). This skill also uses 22 other files; get the full folder from GitHub.
name
faq-shortcuts
description
Turn the questions and instructions a user keeps typing into a project into short slash-command skills, mined from their real Claude Code, Codex and Cursor session history and git log. The shortcuts load in Claude Code, Codex and Cursor. Use when the user says they ask the same things every day, wants an FAQ or shortcuts or abbreviations for a project, wants to "stop writing the whole command", or asks what they repeat most.
argument-hint
[project dir, default cwd] [--source all|claude|codex|cursor] [--since YYYY-MM-DD]

FAQ shortcuts from your own history

People working with an agent on one project type the same asks over and over: "how many signed up", "did it go out?", "send a reminder to those who haven't…". Each time the agent starts cold and has to relearn the traps. This skill mines what was actually asked and turns the most repeated asks into short project skills (/joined, /sent, /remind…). Each one records the right tool and the mistakes already made on that path.

Build from evidence, not from guesses about what might be useful.

1. Collect the asks

bash
python3 scripts/extract_asks.py <project_dir> [--source all|claude|codex|cursor] [--since YYYY-MM-DD] > asks.tsv

On Windows, run it with python instead of python3. This prints every prompt typed in that project's sessions, oldest first, as date<TAB>source<TAB>prompt. It reads Claude Code (~/.claude/projects/, plus ~/.claude/history.jsonl for sessions older than the 30 days Claude Code keeps transcripts), Codex (~/.codex/sessions/, or $CODEX_HOME) and Cursor (its state.vscdb SQLite store) by default, and skips subagent turns and scripted runs such as codex exec, because nobody typed those. An ask repeated across tools counts as one cluster. Cursor chats opened without a folder belong to no project, so they are not read.

Write the output to a scratch location, not into the repo, because prompts can contain names, emails and tokens.

Also read the commit subjects (git log --format='%ad %s' --date=short). Commits show which operations recur, like repeated send-*, sync-* and import-* scripts. Prompts show how the user phrases them.

2. Cluster by intent, then count

Read the whole list. Group prompts that want the same outcome whatever their wording ("how many joined", "how many confirmed", "how many members now" → one head-count ask). Count each cluster and keep 2–3 verbatim phrasings, which become the description's triggers.

A cluster earns a shortcut when:

  • it recurs (roughly 5+ times, or on most working days), and
  • it takes more than one lookup to answer properly, or it has already gone wrong at least once. Look for follow-ups like "you did it wrong", "why did you…", "did you check…".

Drop one-offs and anything a single command already answers.

3. Check what already exists

List .claude/skills/, .claude/commands/, .agents/skills/ and the project's CLAUDE.md and AGENTS.md. Extend an existing skill instead of adding a near-duplicate. Then find the project's existing tools for each cluster, such as scripts, CLI commands and API routes. A shortcut should point to the tool that exists. Don't write a new one.

Read those tools' headers and the commits that fixed them. The traps you find there are the most valuable part of each skill.

Show full SKILL.md (274 more words)Show less

4. Propose before writing

Show the user a short table with shortcut name, the ask it replaces, and how often it appeared. Let them pick. Short names beat descriptive ones here, because the point is less typing. Use one lowercase word, and never shadow a built-in command.

5. Write each skill

.claude/skills/<name>/SKILL.md, committed with the project so it travels. Claude Code and Cursor load skills from .claude/skills/. Codex loads them from .agents/skills/, so link each one there as well:

bash
mkdir -p .agents/skills && ln -s ../../.claude/skills/<name> .agents/skills/<name>

Link each skill folder, not .agents/skills itself: Codex follows a symlinked skill folder but does not scan a symlinked .agents/skills.

The skill file itself:

markdown
---
name: <short>
description: <what it does>. Use for "<verbatim phrasing 1>", "<phrasing 2>", "<phrasing 3>".
argument-hint: "[optional arg]"
---
# <What it answers>

Report only / Dry run first — **never <write/send> from this skill without a yes.**

## Query / tool       ← the existing script or query, with its real flags
## Traps              ← only ones that actually happened, each with the consequence
## Report             ← exactly what to print, then ask

Rules:

  • Split reading from acting. Question skills only report. Action skills dry-run, show the list with every exclusion and its reason, then apply only after a yes.
  • Point to the source for every trap, like the script header, commit or incident. If you can't trace a trap to something that happened, leave it out.
  • Verify every field, flag and file name against the code before you write it down. A shortcut that cites a wrong column fails silently on the day it's needed.
  • Keep a skill short enough to read in a minute. Leave out history, keep the lesson.
  • Quote the frontmatter description if it contains : or #, or YAML will truncate it.

6. Make them findable

Add a table to the project's CLAUDE.md (and AGENTS.md, if the project has one) that maps each shortcut to the sentence it replaces. It serves as both documentation and a reminder to use it.

Report

The shortcuts added, the ask each replaces with its count, and any frequent cluster you deliberately left out and why.

© kishormorol, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 22 other files (scripts) in the repository root of kishormorol/cli-faq-shortcuts.

  • SKILL.md
  • .claude-plugin/marketplace.json
  • .claude-plugin/plugin.json
  • .github/ISSUE_TEMPLATE/bug_report.yml
  • .github/ISSUE_TEMPLATE/feature_request.yml
  • .github/pull_request_template.md
  • .github/workflows/test.yml
  • .gitignore
  • CHANGELOG.md
  • CONTRIBUTING.md
  • LICENSE
  • README.md
  • demo.svg
  • docs/launch-v1.2.0.md
  • docs/media/faq-shortcuts-demo.gif
  • … and 8 more

Open the folder on GitHubat commit 056c5aa

Compare with similar skills

Faq Shortcuts next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Faq Shortcuts compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Faq Shortcuts this skillkishormorol/cli-faq-shortcuts127—~1.4kAutomated safety check: PassApache-2.0
Publish Plugins Version Bumpvinta/hal-9000138—~1kAutomated safety check: PassMIT
Hook Factoryalirezarezvani/claude-code-skill-factory882—~3.1kAutomated safety check: PassMIT
Hns Moaiadk Dev Referencemodu-ai/moai-adk1.2k—~937Automated safety check: PassApache-2.0
Rule Catalogathola/claude-night-market341—~1.6kAutomated safety check: PassMIT
Write Docsbeyonders-studio/initiative171—~3.8kAutomated safety check: PassAGPL-3.0

Similar skills

  • Finds which plugins in the repository changed, bumps only the ones not already bumped since origin/main, and checks that each plugin's two manifests stay in sync.

    138 GitHub stars~1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Hook Factory

    alirezarezvani/claude-code-skill-factory

    Generate production-ready Claude Code hooks with interactive Q&A, automated installation, and enhanced validation.

    882 GitHub stars~3.1k tokensUpdated 11 mo ago
    Agent WorkflowsAuto-check passed
  • moai-adk-go local dev reference — version management/release process (sec 5), shell-script hook development (sec 7), build & dev commands (sec 10).

    1.2k GitHub stars~937 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Rule Catalog

    athola/claude-night-market

    Browse hookify rule catalog. An agent skill from athola/claude-night-market.

    341 GitHub stars~1.6k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Write Docs

    beyonders-studio/initiative

    Write or edit the Initiative help center under docs/en/ — the house voice, the structural rules, and how to build and check the site.

    171 GitHub stars~3.8k tokensUpdated yesterday
    Sales & SupportAuto-check passed
  • Slack Bot Builder

    davila7/claude-code-templates

    Build Slack apps using the Bolt framework across Python, JavaScript, and Java.

    33k GitHub starsUsed in 5 repos~2.2k tokens
    Agent WorkflowsAuto-check passed

Works with

Questions about Faq Shortcuts

What does Faq Shortcuts do?

Turn the questions and instructions a user keeps typing into a project into short slash-command skills, mined from their real Claude Code, Codex and Cursor session history and git log. Faq Shortcuts is an agent skill from kishormorol/cli-faq-shortcuts. Turn the questions and instructions a user keeps typing into a project into short slash-command skills, mined from their real Claude Code, Codex and Cursor session history and git log.

When should I use Faq Shortcuts?

Faq Shortcuts fits situations like: the user says they ask the same things every day; abbreviations for a project; wants to stop writing the whole command; asks what they repeat most.

How do I install Faq Shortcuts in Claude Code?

Run `npx skills add kishormorol/cli-faq-shortcuts --skill faq-shortcuts -a claude-code`. Or copy the skill folder (the kishormorol/cli-faq-shortcuts repository) into .claude/skills/faq-shortcuts in your project. Claude Code loads it when a task matches its description.

How do I install Faq Shortcuts in Codex?

Run `npx skills add kishormorol/cli-faq-shortcuts --skill faq-shortcuts -a codex`. Or copy the skill folder (the kishormorol/cli-faq-shortcuts repository) into .agents/skills/faq-shortcuts in your project. Codex loads it when a task matches its description.

Can I use Faq Shortcuts in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add kishormorol/cli-faq-shortcuts --skill faq-shortcuts -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/faq-shortcuts, .gemini/skills/faq-shortcuts, .github/skills/faq-shortcuts and .opencode/skills/faq-shortcuts in your project.

What does Faq Shortcuts need to run?

Going by SKILL.md and its folder, Faq Shortcuts needs the command-line tools its instructions call (codex, python3, claude and git). Our summary lists: Python 3.

Does Faq Shortcuts access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Faq Shortcuts safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Faq Shortcuts use?

Faq Shortcuts is published under the Apache-2.0 licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Faq Shortcuts use?

About 1.4k tokens (SKILL.md is roughly 5.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Faq Shortcuts?

Skills that share tags, products or a category with Faq Shortcuts: Publish Plugins Version Bump (vinta/hal-9000, 138 stars), Hook Factory (alirezarezvani/claude-code-skill-factory, 882 stars), Hns Moaiadk Dev Reference (modu-ai/moai-adk, 1.2k stars) and Rule Catalog (athola/claude-night-market, 341 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Faq Shortcuts?

kishormorol (a GitHub user) maintains it in kishormorol/cli-faq-shortcuts, which has 127 GitHub stars. The repository was last updated on October 3, 2026.

Source: kishormorol/cli-faq-shortcuts on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.