Scan
wshobson/agents
Scans the codebase to generate project-doc.md and AGENTS.md.
Find the requests you keep making to your AI assistant by scanning Claude Code transcripts and claude.ai exports, clustering them by intent, and ranking each recurring pattern by how promotable it…
MITAuto-check passed
Install Promoter Scan
$ npx skills add mohitagw15856/pm-claude-skills --skill promoter-scan -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install mohitagw15856/pm-claude-skills promoter-scan --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/promoter-scan .claude/skills/promoter-scan && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "promoter-scan" agent skill from https://github.com/mohitagw15856/pm-claude-skills/tree/main/skills/promoter-scan into .claude/skills/promoter-scan/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "promoter-scan", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/mohitagw15856/pm-claude-skills/tree/main/skills/promoter-scanType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add mohitagw15856/pm-claude-skills --skill promoter-scan -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install mohitagw15856/pm-claude-skills promoter-scan --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/promoter-scan .agents/skills/promoter-scan && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "promoter-scan" agent skill from https://github.com/mohitagw15856/pm-claude-skills/tree/main/skills/promoter-scan into .agents/skills/promoter-scan/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "promoter-scan", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add mohitagw15856/pm-claude-skills --skill promoter-scan -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install mohitagw15856/pm-claude-skills promoter-scan --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/promoter-scan .cursor/skills/promoter-scan && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "promoter-scan" agent skill from https://github.com/mohitagw15856/pm-claude-skills/tree/main/skills/promoter-scan into .cursor/skills/promoter-scan/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "promoter-scan", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/mohitagw15856/pm-claude-skills.git --path skills/promoter-scan--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add mohitagw15856/pm-claude-skills --skill promoter-scan -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install mohitagw15856/pm-claude-skills promoter-scan --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/promoter-scan .gemini/skills/promoter-scan && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "promoter-scan" agent skill from https://github.com/mohitagw15856/pm-claude-skills/tree/main/skills/promoter-scan into .gemini/skills/promoter-scan/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "promoter-scan", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install mohitagw15856/pm-claude-skills promoter-scanInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add mohitagw15856/pm-claude-skills --skill promoter-scan -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/promoter-scan .github/skills/promoter-scan && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "promoter-scan" agent skill from https://github.com/mohitagw15856/pm-claude-skills/tree/main/skills/promoter-scan into .github/skills/promoter-scan/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "promoter-scan", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add mohitagw15856/pm-claude-skills --skill promoter-scan -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install mohitagw15856/pm-claude-skills promoter-scan --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/promoter-scan .opencode/skills/promoter-scan && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "promoter-scan" agent skill from https://github.com/mohitagw15856/pm-claude-skills/tree/main/skills/promoter-scan into .opencode/skills/promoter-scan/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "promoter-scan", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
promoter-scan- GitHub stars
- 1.4k
- Token cost
- ~1.3k tokens
- SKILL.md length
- 677 words
- Files
- 2 (incl. scripts)
- Skills in repo
- 1,348
- Repo updated
- First seen
- Licence
- MIT
At a glance
Find the requests you keep making to your AI assistant by scanning Claude Code transcripts and claude.ai exports, clustering them by intent, and ranking each recurring pattern by how promotable it…
- Asked what do I keep asking for
- SKILL.md covers What This Skill Produces, Required Inputs, Framework: Promotability and Programmatic Helper, plus 4 more sections
- Runs Python scripts from its folder; calls python3
- Scan my transcripts
What it does
Promoter Scan is an agent skill from mohitagw15856/pm-claude-skills. Find the requests you keep making to your AI assistant by scanning Claude Code transcripts and claude.ai exports, clustering them by intent, and ranking each recurring pattern by how promotable it is into a reusable skill. Use when asked what do I keep asking for, scan my transcripts, find repeated prompts, which of my prompts should become skills, or to start the promote loop. Produces a ranked report of recurring patterns with frequency, redacted example prompts, the variation between them, and a promotability…
Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/promoter_scan.py`).
The repository describes itself as: 1255 professional Agent Skills for Claude, ChatGPT, Gemini, Cursor & Codex — PRDs, postmortems, leases, medical bills, layoffs, go-bags, new countries. Plain markdown, MIT, in… The licence is MIT.
When your agent uses it
- Asked what do I keep asking for
- Scan my transcripts
- Find repeated prompts
- Which of my prompts should become skills
Example prompts
- “/promoter-scan”
Requirements
- Python 3
What it can do on your machine
Read from SKILL.md and the folder at commit 1cbf1f0. 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/ (Python), which the agent can run.
Shell commands in SKILL.md call:
python3
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
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
Promoter Scan loads about 1.3k tokens when it runs. Until then it costs about 135 tokens; SKILL.md has 677 words of instructions outside code blocks.
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 mohitagw15856/pm-claude-skills at commit 1cbf1f0, republished under its MIT licence (© mohitagw15856). 677 words, ~1,317 tokens.
Download SKILL.mdSave it as
.claude/skills/promoter-scan/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.- name
- promoter-scan
- description
- Find the requests you keep making to your AI assistant by scanning Claude Code transcripts and claude.ai exports, clustering them by intent, and ranking each recurring pattern by how promotable it is into a reusable skill. Use when asked what do I keep asking for, scan my transcripts, find repeated prompts, which of my prompts should become skills, or to start the promote loop. Produces a ranked report of recurring patterns with frequency, redacted example prompts, the variation between them, and a promotability score.
- version
- 1.0.0
Promoter Scan
Most people have five or six prompts they type every week with small variations. Each one is a skill that has not been written down yet. This skill reads your own transcripts, groups the requests by what they are trying to do, and ranks the groups by how much they would gain from becoming a skill: often asked, phrased consistently, with clear inputs and outputs.
It is the first step of the promote loop: scan, draft, test, publish. The /promote command runs the whole loop.
What This Skill Produces
- A ranked table of recurring patterns: name, how many times it was asked, a promotability score from 0 to 100, and the three components behind it (frequency, consistency, clear inputs and outputs)
- Per pattern, up to three example prompts, redacted, plus a one-line reading of the variation between them and a verdict: promote, maybe, leave
- A JSON version of the same report for the draft step, so nothing is retyped
Required Inputs
Ask for these if not provided:
- Where the transcripts are. Claude Code keeps session transcripts as
*.jsonlunder~/.claude/projects/<project>/. A claude.ai export is aconversations.jsoninside the downloaded archive. Either or both work; a folder is fine. - The minimum count worth reporting (default 3) and, if the user wants, a date range to limit the scan
- Anything that must never appear in the report beyond the built-in redaction (client names, project codenames)
Framework: Promotability
A pattern is worth promoting when all three are true:
| Component | Weight | High when |
|---|---|---|
| Frequency | 50% | it comes up often relative to everything else the user asks |
| Consistency | 30% | the prompts share vocabulary; the same job, not a family of jobs |
| Clear inputs and outputs | 20% | the prompts say what goes in ("from this git log") and what comes out ("as a table") |
Verdicts: 60 and above is promote; 35 to 59 is maybe, usually a family that needs splitting into two skills; below 35 is leave alone.
Redaction is not optional. Emails, phone numbers, card and account numbers, API keys, tokens, passwords and URLs are replaced before anything is written to the report. If the user names extra terms to strip, strip them too. When in doubt, paraphrase the example rather than quote it.
Programmatic Helper
scripts/promoter_scan.py does the reading, redaction, clustering and scoring. Stdlib only.
python3 skills/promoter-scan/scripts/promoter_scan.py ~/.claude/projects/my-project --json scan-report.json
python3 skills/promoter-scan/scripts/promoter_scan.py ~/Downloads/claude-export/conversations.json --min-count 4It prints the markdown report and, with --json, writes the clusters for the draft step. Run it first; use the output as the evidence, then add the human reading of each pattern that the script cannot give (whether two clusters are really one job, whether a high scorer is actually a one-off spree).
Show full SKILL.md (240 more words)Show less
Output Format
Promoter scan: [source], [N] user turns, [date range]
| # | Pattern | Times | Score | Frequency | Consistency | Clear I/O |
|---|
1. [pattern name] (score, times)
Example prompts (redacted):
- ...
- ...
- ...
Variation: [low / medium / high, and what varies: the source material, the audience, the format].
Verdict: [promote / maybe / leave], because ...
Suggested skill name: [kebab-name]
What to promote first
[The one pattern with the best score-to-effort ratio and why]
Quality Checks
- Every example prompt has been through redaction and contains no email, key, number sequence or URL
- Each pattern is one job; families ("summarise X" for five different Xs) are flagged as maybe with a note on how to split
- The score components are shown, not just the total
- One-off sprees (ten asks in one afternoon, never again) are called out rather than promoted
- A suggested skill name is given for every promote verdict, checked against the library for collisions
Anti-Patterns
- Quoting a prompt verbatim because it looked harmless. Redact first, judge later.
- Promoting by frequency alone. Fifty variations of "help" are not a skill.
- Merging jobs that share a verb. "Summarise a thread" and "summarise a paper" want different frameworks.
- Scanning other people's transcripts. The loop is for the user's own usage, with their consent to read it.
Example Trigger Phrases
- "What do I keep asking Claude for?"
- "Scan my transcripts and tell me which prompts should be skills."
- "Find my repeated prompts from the last month."
- "Start the promote loop on my Claude Code sessions."
© mohitagw15856, MIT. 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 1 other file (scripts) in skills/promoter-scan of mohitagw15856/pm-claude-skills.
- SKILL.md
- scripts/promoter_scan.py
Open the folder on GitHubat commit 1cbf1f0
Compare with similar skills
Promoter Scan 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Promoter Scan this skillmohitagw15856/pm-claude-skills | 1.4k | — | ~1.3k | Automated safety check: Pass | MIT | |
| Scanwshobson/agents | 40k | — | ~2.2k | Automated safety check: Pass | MIT | |
| Repo Scanaffaan-m/ECC | 276k | — | ~1.5k | Automated safety check: Pass | MIT | |
| Repo Scanaffaan-m/ECC | 276k | — | ~1.3k | Automated safety check: Pass | MIT | |
| Vulnerability Scanningsickn33/agentic-awesome-skills | 47k | 1 repos | ~2.8k | Automated safety check: Pass | MIT | |
| Repo Scanaffaan-m/ECC | 277k | 1 repos | ~1.8k | Automated safety check: Pass | MIT |
Similar skills
Repo Scan
affaan-m/ECC
固定されレビュー可能なコミットから外部の repo-scan スキルをインストールするブートストラップ用ポインター。クロススタックのソースコード資産監査を実行する前に repo-scan のインストールが必要な場合に使用する。この ECC ポインター自体は監査を実行しない。
Repo Scan
affaan-m/ECC
用于从固定且可审查的提交安装外部 repo-scan 技能的引导指针。在运行跨栈源代码资产审计前需要安装 repo-scan 时使用；此 ECC 指针本身不执行审计。
Vulnerability Scanning
sickn33/agentic-awesome-skills
Scan systems and dependencies for CVEs and security vulnerabilities.
Repo Scan
affaan-m/ECC
Bootstrap pointer that installs the external repo-scan skill from a pinned, reviewable commit.
Security Scan
affaan-m/ECC
Scan your Claude Code configuration (.claude/ directory) for security vulnerabilities, misconfigurations, and injection risks using AgentShield.
More from mohitagw15856/pm-claude-skills
All 1,348 skills in this repoCar Tco
mohitagw15856/pm-claude-skills
Compare the total cost of car ownership across buy-new, buy-used, lease, and keep-your-current-car — depreciation, insurance, maintenance ramp, and fuel over a real horizon, not just the monthly…
Cs Health Scorecard
mohitagw15856/pm-claude-skills
Build a customer health scorecard for a specific account. An agent skill from mohitagw15856/pm-claude-skills.
Exit Waterfall
mohitagw15856/pm-claude-skills
Compute who gets what at each exit price from a cap table — liquidation preferences, conversion points, and where the founders' share collapses.
Feature Prioritisation
mohitagw15856/pm-claude-skills
Apply prioritisation frameworks (RICE, MoSCoW, Kano, ICE, Opportunity Scoring) to rank features and backlog items.
Fire Number
mohitagw15856/pm-claude-skills
Compute a financial-independence (FIRE) target and years-to-reach with every assumption labeled as an assumption — plus a sensitivity table instead of a single false-precision answer.
Freelance Rate
mohitagw15856/pm-claude-skills
Derive a freelance day/hourly rate backwards from target income, honest billable utilization, overhead, and the self-employment tax premium — the arithmetic that proves a rate is not salary÷2000.
Questions about Promoter Scan
What does Promoter Scan do?
Find the requests you keep making to your AI assistant by scanning Claude Code transcripts and claude.ai exports, clustering them by intent, and ranking each recurring pattern by how promotable it…. Promoter Scan is an agent skill from mohitagw15856/pm-claude-skills.ai exports, clustering them by intent, and ranking each recurring pattern by how promotable it is into a reusable skill.
When should I use Promoter Scan?
Promoter Scan fits situations like: asked what do I keep asking for; scan my transcripts; find repeated prompts; which of my prompts should become skills.
How do I install Promoter Scan in Claude Code?
Run `npx skills add mohitagw15856/pm-claude-skills --skill promoter-scan -a claude-code`. Or copy the skill folder (skills/promoter-scan in mohitagw15856/pm-claude-skills) into .claude/skills/promoter-scan in your project. Claude Code loads it when a task matches its description.
How do I install Promoter Scan in Codex?
Run `npx skills add mohitagw15856/pm-claude-skills --skill promoter-scan -a codex`. Or copy the skill folder (skills/promoter-scan in mohitagw15856/pm-claude-skills) into .agents/skills/promoter-scan in your project. Codex loads it when a task matches its description.
Can I use Promoter Scan 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 mohitagw15856/pm-claude-skills --skill promoter-scan -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/promoter-scan, .gemini/skills/promoter-scan, .github/skills/promoter-scan and .opencode/skills/promoter-scan in your project.
What does Promoter Scan need to run?
Going by SKILL.md and its folder, Promoter Scan needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.
Does Promoter Scan access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Promoter Scan 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 Promoter Scan use?
Promoter Scan is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Promoter Scan use?
About 1.3k tokens (SKILL.md is roughly 5.3k 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 Promoter Scan?
Skills that share tags, products or a category with Promoter Scan: Scan (wshobson/agents, 40k stars), Repo Scan (affaan-m/ECC, 276k stars), Repo Scan (affaan-m/ECC, 276k stars) and Vulnerability Scanning (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Promoter Scan?
mohitagw15856 (a GitHub user) maintains it in mohitagw15856/pm-claude-skills, which has 1,434 GitHub stars. The repository holds 1,348 skills in this directory. The repository was last updated on October 9, 2026.
Source: mohitagw15856/pm-claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.