From ed8a74c42421962ef4aa24c8cfd364a47bd78966 Mon Sep 17 00:00:00 2001 From: VanhoeyB Date: Tue, 6 Oct 2026 08:20:34 +0200 Subject: [PATCH 1/2] =?UTF-8?q?=F0=9F=93=9D=20docs:=20rename=20AdvancedCla?= =?UTF-8?q?udeCode=20to=20ClaudeCodePowerUserGuide=20and=20merge=20Skills?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Folds Skills.md into the guide so all skill tips live in one file, and adds sections on Claude Code mods and the next-steps plugin. --- AdvancedClaudeCode.md | 143 ------------------------ ClaudeCodePowerUserGuide.md | 214 ++++++++++++++++++++++++++++++++++++ Skills.md | 65 ----------- 3 files changed, 214 insertions(+), 208 deletions(-) delete mode 100644 AdvancedClaudeCode.md create mode 100644 ClaudeCodePowerUserGuide.md delete mode 100644 Skills.md diff --git a/AdvancedClaudeCode.md b/AdvancedClaudeCode.md deleted file mode 100644 index 5bf3b80..0000000 --- a/AdvancedClaudeCode.md +++ /dev/null @@ -1,143 +0,0 @@ -# Advanced Claude Code - -## shortcuts - -Generate key shortcuts for Claude Code. -c -> claude - -add a bat file 'c.bat' to your path notepad "C:\Users\\.local\bin\c.bat" - -with the following content: - -```bat - @claude %* -``` - -Now, when you are in the explorer, enter "CTRL+L" to select the path, then type "cmd" and hit enter to open a command prompt in that directory. Type "c" and hit enter to run Claude Code in that directory. - -## keyboard text replacement shortcuts for Claude Code - -u=> ultrathink -w => what happened - -## YOLO Mode (You Only Live Once) - -YOLO mode" has a specific meaning too: it refers to running a tool with all safety confirmations disabled. For example, Claude Code has a --dangerously-skip-permissions flag that people informally call "YOLO mode," where it stops asking for approval before each action and just executes. Handy but risky, hence the name. - -```batch - claude --dangerously-skip-permissions -``` - -## Install Claude Code Docs - -## Session Tracker Tool for Claude Code usage - -[Usage Monitor](https://github.com/jens-duttke/usage-monitor-for-claude) - -## AskForUserQuestion - -AskForUserQuestion is a built-in tool in Claude Code that prompts the user for input before executing certain actions. It ensures that the user explicitly confirms or provides necessary information, adding an extra layer of safety and interactivity to the workflow. - -## Useful Claude Code Skills - -Running the skill below will audit your skills, and it will find a bunch of potential issues or improvements in your prompts. - -```bash -/claude-api prompt-audit -``` - -### Built-in skills (ship with Claude Code) - -**Migrate API code to a newer Claude model.** Sibling of `prompt-audit`: it classifies every file that calls the Claude API, applies the breaking changes for the target model, and then audits the prompts for patterns written for the old model. - -```bash -/claude-api migrate -``` - -**Fewer permission prompts.** Scans your past session transcripts for read-only Bash and MCP calls you keep approving, then writes a prioritized allowlist into `.claude/settings.json` so those prompts stop appearing. - -```bash -/fewer-permission-prompts -``` - -**Simplify the current diff.** A quality-only pass over your changed code (reuse, simplification, efficiency) that applies the fixes for you. It does not hunt for bugs; use `/code-review` for that. - -```bash -/simplify -``` - -**Code review with effort levels and auto-fix.** Reviews the current diff, a PR number, a branch or a path. `low`/`medium` give fewer high-confidence findings, `high`/`max` go broader. `--fix` applies the findings to the working tree, `--comment` posts them as inline PR comments. - -```bash -/code-review high -/code-review 42 --comment -/code-review --fix -``` - -**Security review of pending changes.** Runs a dedicated security review on the uncommitted or unpushed changes on the current branch. - -```bash -/security-review -``` - -**Run the app to prove a change works.** Detects the project type (CLI, server, TUI, Electron, browser app) and launches it so Claude can see the change working in the real app instead of only in tests. - -```bash -/run -``` - -**Recurring tasks with /loop.** Runs a prompt or slash command on an interval. Omit the interval and Claude paces itself. - -```bash -/loop 5m /standup -/loop check whether the deploy on staging finished -``` - -**Scheduled cloud agents.** Creates routines that run on a cron schedule in the cloud, or a one-time run at a given time, without keeping your terminal open. - -```bash -/schedule -``` - -**Configure hooks, permissions and env vars in plain English.** Anything phrased as "from now on when X" needs a hook in `settings.json`; this skill writes it for you. Also handles "allow npm commands" or "set DEBUG=true". - -```bash -/update-config when a file is edited run prettier on it -``` - -**Customize keyboard shortcuts.** Rebind keys, add chord bindings or change the submit key via `~/.claude/keybindings.json`. - -```bash -/keybindings-help -``` - -**Skill health check.** Reports on the quality of your installed skills (descriptions, triggering, structure). Pair it with `claude plugin eval` to run eval suites against a plugin in CI. - -```bash -/skill-doctor -``` - -### Plugin skills worth installing - -**skill-creator** (official marketplace). Creates skills from scratch, runs evals against them, benchmarks variance between runs and optimizes the description so the skill triggers when it should. - -```bash -/skill-creator -``` - -**mattpocock-skills** (official marketplace). A small set of workflow skills: - -- `/grilling` stress-tests a plan or decision by relentlessly questioning it before you build. -- `/wizard` generates an interactive bash wizard for steps only a human can do (credentials, CI secrets, third-party dashboards). -- `/diagnosing-bugs` is a structured diagnosis loop for hard bugs and performance regressions. -- `/writing-for-agents` gives guidance for writing CLAUDE.md, AGENTS.md and skill files that agents actually follow. - -```bash -claude plugin install mattpocock-skills@claude-plugins-official -``` - -**anthropic-agent-skills marketplace.** Besides `claude-api` it ships `mcp-builder` (scaffold an MCP server), `webapp-testing` (drive a web app with Playwright), `frontend-design`, and document skills for `docx`, `pptx`, `xlsx` and `pdf`. - -```bash -/plugin marketplace add anthropics/skills -``` diff --git a/ClaudeCodePowerUserGuide.md b/ClaudeCodePowerUserGuide.md new file mode 100644 index 0000000..44f42f4 --- /dev/null +++ b/ClaudeCodePowerUserGuide.md @@ -0,0 +1,214 @@ +# Claude Code Power User Guide + +## shortcuts + +Generate key shortcuts for Claude Code. +c -> claude + +add a bat file 'c.bat' to your path notepad "C:\Users\\.local\bin\c.bat" + +with the following content: + +```bat + @claude %* +``` + +Now, when you are in the explorer, enter "CTRL+L" to select the path, then type "cmd" and hit enter to open a command prompt in that directory. Type "c" and hit enter to run Claude Code in that directory. + +## keyboard text replacement shortcuts for Claude Code + +u=> ultrathink +w => what happened + +## YOLO Mode (You Only Live Once) + +YOLO mode" has a specific meaning too: it refers to running a tool with all safety confirmations disabled. For example, Claude Code has a --dangerously-skip-permissions flag that people informally call "YOLO mode," where it stops asking for approval before each action and just executes. Handy but risky, hence the name. + +```batch + claude --dangerously-skip-permissions +``` + +## Install Claude Code Docs + +## Session Tracker Tool for Claude Code usage + +[Usage Monitor](https://github.com/jens-duttke/usage-monitor-for-claude) + +## AskForUserQuestion + +AskForUserQuestion is a built-in tool in Claude Code that prompts the user for input before executing certain actions. It ensures that the user explicitly confirms or provides necessary information, adding an extra layer of safety and interactivity to the workflow. + +## Useful Claude Code Skills + +Claude Code Skills are modular, file-based extensions — each one a folder with a `SKILL.md` (plus optional scripts/resources) that packages domain knowledge or a specific workflow. Claude loads a skill's full instructions only when it's relevant (matched by its description or invoked explicitly via `/skill-name`), keeping the rest of the context window free. They're how you give Claude reusable, specialized capabilities — like a particular review process, a design system, or a deployment routine — without bloating every conversation with instructions it doesn't need yet. + +Running the skill below will audit your skills, and it will find a bunch of potential issues or improvements in your prompts. + +```bash +/claude-api prompt-audit +``` + +### Built-in skills (ship with Claude Code) + +**Migrate API code to a newer Claude model.** Sibling of `prompt-audit`: it classifies every file that calls the Claude API, applies the breaking changes for the target model, and then audits the prompts for patterns written for the old model. + +```bash +/claude-api migrate +``` + +**Fewer permission prompts.** Scans your past session transcripts for read-only Bash and MCP calls you keep approving, then writes a prioritized allowlist into `.claude/settings.json` so those prompts stop appearing. + +```bash +/fewer-permission-prompts +``` + +**Simplify the current diff.** A quality-only pass over your changed code (reuse, simplification, efficiency) that applies the fixes for you. It does not hunt for bugs; use `/code-review` for that. + +```bash +/simplify +``` + +**Code review with effort levels and auto-fix.** Reviews the current diff, a PR number, a branch or a path. `low`/`medium` give fewer high-confidence findings, `high`/`max` go broader. `--fix` applies the findings to the working tree, `--comment` posts them as inline PR comments. + +```bash +/code-review high +/code-review 42 --comment +/code-review --fix +``` + +**Security review of pending changes.** Runs a dedicated security review on the uncommitted or unpushed changes on the current branch. + +```bash +/security-review +``` + +**Run the app to prove a change works.** Detects the project type (CLI, server, TUI, Electron, browser app) and launches it so Claude can see the change working in the real app instead of only in tests. + +```bash +/run +``` + +**Recurring tasks with /loop.** Runs a prompt or slash command on an interval. Omit the interval and Claude paces itself. + +```bash +/loop 5m /standup +/loop check whether the deploy on staging finished +``` + +**Scheduled cloud agents.** Creates routines that run on a cron schedule in the cloud, or a one-time run at a given time, without keeping your terminal open. + +```bash +/schedule +``` + +**Configure hooks, permissions and env vars in plain English.** Anything phrased as "from now on when X" needs a hook in `settings.json`; this skill writes it for you. Also handles "allow npm commands" or "set DEBUG=true". + +```bash +/update-config when a file is edited run prettier on it +``` + +**Customize keyboard shortcuts.** Rebind keys, add chord bindings or change the submit key via `~/.claude/keybindings.json`. + +```bash +/keybindings-help +``` + +**Skill health check.** Reports on the quality of your installed skills (descriptions, triggering, structure). Pair it with `claude plugin eval` to run eval suites against a plugin in CI. + +```bash +/skill-doctor +``` + +### Plugin skills worth installing + +**[skill-creator](https://skillsmp.com/creators/anthropics/skills/skills-skill-creator)** (official marketplace). A meta-skill that guides you through creating your own Claude Code Skill, with best practices for writing clear instructions, defining triggers and structuring files. It generates a boilerplate `SKILL.md` and folder structure from your input, runs evals against the skill, benchmarks variance between runs and optimizes the description so the skill triggers when it should. + +```bash +/plugin marketplace add anthropics/skills +/skill-creator +``` + +**mattpocock-skills** (official marketplace). A small set of workflow skills: + +- `/grilling` stress-tests a plan or decision by relentlessly questioning it before you build. +- `/wizard` generates an interactive bash wizard for steps only a human can do (credentials, CI secrets, third-party dashboards). +- `/diagnosing-bugs` is a structured diagnosis loop for hard bugs and performance regressions. +- `/writing-for-agents` gives guidance for writing CLAUDE.md, AGENTS.md and skill files that agents actually follow. + +```bash +claude plugin install mattpocock-skills@claude-plugins-official +``` + +**anthropic-agent-skills marketplace.** Besides `claude-api` it ships `mcp-builder` (scaffold an MCP server), `webapp-testing` (drive a web app with Playwright), `frontend-design`, and document skills for `docx`, `pptx`, `xlsx` and `pdf`. + +```bash +/plugin marketplace add anthropics/skills +``` + +### Community skills + +**[Frontend Design Skill by Anthropic](https://skillsmp.com/creators/anthropics/skills/skills-frontend-design).** Guides Claude to commit to a distinctive design direction (purpose, tone, constraints, differentiation) before writing any UI code, and bans generic AI defaults like Inter, Roboto, and purple gradients — so output doesn't look templated. + +```text +npx skills add https://github.com/anthropics/skills --skill frontend-design + +/frontend-design +``` + +**[Grill with Docs by Matt Pocock](https://github.com/mattpocock/skills/blob/main/skills/engineering/grill-with-docs/SKILL.md).** A Socratic, interview-style planning skill: it grills you on a proposed change one question at a time, checks your answers against the codebase and existing docs, and writes confirmed terminology and decisions back into `CONTEXT.md` and ADRs (Architecture Decision Records) as you go. Best used before starting a significant change. + +```text +npx skills@latest add mattpocock/skills + +/grill-with-docs +``` + +**[Test Driven Development Workflow by Affaan-m](https://github.com/affaan-m/ECC/tree/main/skills/tdd-workflow).** Enforces a strict red-green-refactor TDD cycle (user journeys → write failing tests → minimal implementation → pass tests → refactor → verify 80%+ coverage → evidence report) for new features, bug fixes, and refactors, with Git checkpoints at each stage. + +```text +npx skills add https://github.com/affaan-m/ECC --skill tdd-workflow + +/tdd-workflow +``` + +**[Code Reviewer Skill by Shubhamsaboo](https://github.com/Shubhamsaboo/awesome-llm-apps/tree/main/awesome_agent_skills/code-reviewer).** A prioritized code review skill that checks security (SQL injection, XSS, secrets) first, then performance, correctness, maintainability, and test coverage, surfacing findings by severity with concrete fix suggestions. Use it on PRs, pre-deployment code, or security audits. + +```text +npx skills add https://github.com/Shubhamsaboo/awesome-llm-apps --skill code-reviewer + +/code-reviewer +``` + +## Mods + +Mods are a Claude Code feature launched October 1, 2026: small TypeScript functions that change how Claude Code works. You can write one yourself or ask Claude Code to write it for you. + +- **How they work:** Claude Code emits an event whenever it does something, and a mod hooks into those events. Unlike regular hooks, a mod's handlers are functions running inside Claude Code, so they can also replace or restyle what Claude Code draws itself (a tool call's row, the spinner, the question dialog). Anthropic's "Blast Radius" sample shows an explanation of a high-risk command like `rm -rf` in a side pane. +- **Built-in mods:** some core features, such as `/diff`, are already mods. Anthropic plans to move more over time so you can shrink Claude Code to a small core and add back only what you want. +- **Requirements:** Claude Code v2.1.287 or later (on by default), in the CLI and the Code tab of the Claude Desktop app. Behavior differs in the VS Code extension, `claude -p` and cloud sessions. +- **Distribution:** mods ship inside plugins, so existing plugin controls apply. Install with `/plugin install name@marketplace`; `/plugin` shows which mods a session loaded. +- **Security:** mods have the same machine access as Claude Code, aren't sandboxed, and run inside the Claude Code process where classic endpoint security tools can't see them. Install only from trusted authors or marketplaces and check them first with `claude plugin validate`. + +```bash +claude plugin validate +``` + +## next-steps plugin + +next-steps is a small productivity plugin by Thariq Shihipar (MIT, v1.0.0) that suggests what to type next after Claude finishes a turn. It isn't a skill or slash command but a mod: a function-hooks plugin (`hooks/register.tsx`). + +After each answer it shows up to three suggested prompts above the input box: + +```text +next: + 1: run the tests you just wrote + 2: do the same for the settings page + 3: /code-review high + 0: dismiss +``` + +- Press `1`, `2` or `3` on an empty prompt to put that suggestion into the box as an editable draft; `0` dismisses them. The top suggestion also shows as ghost text, so `Tab` accepts it. Nothing is submitted until you press Enter. +- Suggestions come from a fork of your session that shares its prompt cache, so it costs about one short reply and never blocks your turn. Your skills and slash commands are passed along, so a suggestion can be a command like `/code-review high`. +- The output is treated as untrusted: escape sequences, control and invisible Unicode characters are stripped, and text containing Unicode tag characters is rejected, so a hidden prompt injection can't reach your prompt box. + +Config options: `minAnswerChars` (default `80`, no suggestions after shorter answers) and `suggestSkills` (default `true`, passes your skills and commands to the suggester). diff --git a/Skills.md b/Skills.md deleted file mode 100644 index 8bae222..0000000 --- a/Skills.md +++ /dev/null @@ -1,65 +0,0 @@ -# Skills - -Claude Code Skills are modular, file-based extensions — each one a folder with a `SKILL.md` (plus optional scripts/resources) that packages domain knowledge or a specific workflow. Claude loads a skill's full instructions only when it's relevant (matched by its description or invoked explicitly via `/skill-name`), keeping the rest of the context window free. They're how you give Claude reusable, specialized capabilities — like a particular review process, a design system, or a deployment routine — without bloating every conversation with instructions it doesn't need yet. - -## Useful Skills - -### 1. Frontend Design Skill by Anthropic - -[Frontend Design Skill by Anthropic](https://skillsmp.com/creators/anthropics/skills/skills-frontend-design) - -Guides Claude to commit to a distinctive design direction (purpose, tone, constraints, differentiation) before writing any UI code, and bans generic AI defaults like Inter, Roboto, and purple gradients — so output doesn't look templated. - -```text - npx skills add https://github.com/anthropics/skills --skill frontend-design - - /frontend-design -``` - -### 2. Grill with Docs by Matt Pocock - -[Grill with Docs by Matt Pocock](https://github.com/mattpocock/skills/blob/main/skills/engineering/grill-with-docs/SKILL.md) - -A Socratic, interview-style planning skill: it grills you on a proposed change one question at a time, checks your answers against the codebase and existing docs, and writes confirmed terminology and decisions back into `CONTEXT.md` and ADRs (Architecture Decision Record) as you go. Best used before starting a significant change. - -```text - npx skills@latest add mattpocock/skills - - /grill-with-docs -``` - -### 3. Test Driven Development Workflow by Affaan-m - -[Test Driven Development Workflow by Affaan-m](https://github.com/affaan-m/ECC/tree/main/skills/tdd-workflow) - -Enforces a strict red-green-refactor TDD cycle (user journeys → write failing tests → minimal implementation → pass tests → refactor → verify 80%+ coverage → evidence report) for new features, bug fixes, and refactors, with Git checkpoints at each stage. - -```text - npx skills add https://github.com/affaan-m/ECC --skill tdd-workflow - - /tdd-workflow -``` - -### 4. Code Reviewer Skill by Shubhamsaboo - -[Code Reviewer Skill by Shubhamsaboo](https://github.com/Shubhamsaboo/awesome-llm-apps/tree/main/awesome_agent_skills/code-reviewer) - -A prioritized code review skill that checks security (SQL injection, XSS, secrets) first, then performance, correctness, maintainability, and test coverage, surfacing findings by severity with concrete fix suggestions. Use it on PRs, pre-deployment code, or security audits. - -```text - npx skills add https://github.com/Shubhamsaboo/awesome-llm-apps --skill code-reviewer - - /code-reviewer -``` - -### 5. Skill Creator by Anthropic - -[Skill Creator by Anthropic](https://skillsmp.com/creators/anthropics/skills/skills-skill-creator) -A meta-skill that guides you through creating your own Claude Code Skill, with best practices for writing clear instructions, defining triggers, and structuring files. It generates a boilerplate `SKILL.md` and folder structure based on your input, so you can focus on the unique logic of your skill instead of setup. - -```text - /plugin marketplace add anthropics/skills - - /skill-creator -``` - From 5c2eb6201e4045fbeecba325a311498ea54a3ad7 Mon Sep 17 00:00:00 2001 From: VanhoeyB Date: Tue, 6 Oct 2026 08:30:41 +0200 Subject: [PATCH 2/2] =?UTF-8?q?=F0=9F=93=9D=20docs:=20move=20Mods=20sectio?= =?UTF-8?q?n=20from=20power=20user=20guide=20to=20README?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ClaudeCodePowerUserGuide.md | 16 +--------------- README.md | 15 +++++++++++++++ 2 files changed, 16 insertions(+), 15 deletions(-) diff --git a/ClaudeCodePowerUserGuide.md b/ClaudeCodePowerUserGuide.md index 44f42f4..7eba9fa 100644 --- a/ClaudeCodePowerUserGuide.md +++ b/ClaudeCodePowerUserGuide.md @@ -179,23 +179,9 @@ npx skills add https://github.com/Shubhamsaboo/awesome-llm-apps --skill code-rev /code-reviewer ``` -## Mods - -Mods are a Claude Code feature launched October 1, 2026: small TypeScript functions that change how Claude Code works. You can write one yourself or ask Claude Code to write it for you. - -- **How they work:** Claude Code emits an event whenever it does something, and a mod hooks into those events. Unlike regular hooks, a mod's handlers are functions running inside Claude Code, so they can also replace or restyle what Claude Code draws itself (a tool call's row, the spinner, the question dialog). Anthropic's "Blast Radius" sample shows an explanation of a high-risk command like `rm -rf` in a side pane. -- **Built-in mods:** some core features, such as `/diff`, are already mods. Anthropic plans to move more over time so you can shrink Claude Code to a small core and add back only what you want. -- **Requirements:** Claude Code v2.1.287 or later (on by default), in the CLI and the Code tab of the Claude Desktop app. Behavior differs in the VS Code extension, `claude -p` and cloud sessions. -- **Distribution:** mods ship inside plugins, so existing plugin controls apply. Install with `/plugin install name@marketplace`; `/plugin` shows which mods a session loaded. -- **Security:** mods have the same machine access as Claude Code, aren't sandboxed, and run inside the Claude Code process where classic endpoint security tools can't see them. Install only from trusted authors or marketplaces and check them first with `claude plugin validate`. - -```bash -claude plugin validate -``` - ## next-steps plugin -next-steps is a small productivity plugin by Thariq Shihipar (MIT, v1.0.0) that suggests what to type next after Claude finishes a turn. It isn't a skill or slash command but a mod: a function-hooks plugin (`hooks/register.tsx`). +next-steps is a small productivity plugin by Thariq Shihipar (MIT, v1.0.0) that suggests what to type next after Claude finishes a turn. It isn't a skill or slash command but a [mod](README.md#mods): a function-hooks plugin (`hooks/register.tsx`). After each answer it shows up to three suggested prompts above the input box: diff --git a/README.md b/README.md index 61f3b56..108489e 100644 --- a/README.md +++ b/README.md @@ -55,6 +55,7 @@ A few core ideas explain most of how Claude Code behaves — each is covered in - [Installing an MCP server](#installing-an-mcp-server) - [Hooks](#hooks) - [Building a Hook](#building-a-hook) + - [Mods](#mods) - [Subagents](#subagents) - [Skills vs. Subagents](#skills-vs-subagents) - [Progressive Disclosure](#progressive-disclosure) @@ -322,6 +323,20 @@ Key environment variables available in hook commands: ![Tools with Claude Code](images/claude_tools.png) +## Mods + +Mods are a Claude Code feature launched October 1, 2026: small TypeScript functions that change how Claude Code works. You can write one yourself or ask Claude Code to write it for you. + +- **How they work:** Claude Code emits an event whenever it does something, and a mod hooks into those events. Unlike regular [hooks](#hooks), a mod's handlers are functions running inside Claude Code, so they can also replace or restyle what Claude Code draws itself (a tool call's row, the spinner, the question dialog). Anthropic's "Blast Radius" sample shows an explanation of a high-risk command like `rm -rf` in a side pane. +- **Built-in mods:** some core features, such as `/diff`, are already mods. Anthropic plans to move more over time so you can shrink Claude Code to a small core and add back only what you want. +- **Requirements:** Claude Code v2.1.287 or later (on by default), in the CLI and the Code tab of the Claude Desktop app. Behavior differs in the VS Code extension, `claude -p` and cloud sessions. +- **Distribution:** mods ship inside [plugins](#marketplace-and-plugins), so existing plugin controls apply. Install with `/plugin install name@marketplace`; `/plugin` shows which mods a session loaded. +- **Security:** mods have the same machine access as Claude Code, aren't sandboxed, and run inside the Claude Code process where classic endpoint security tools can't see them. Install only from trusted authors or marketplaces and check them first with `claude plugin validate`. + +```bash +claude plugin validate +``` + ## Subagents Subagents are agents spawned by the main agent to handle delegated or parallel subtasks. Each subagent starts fresh with its own isolated context and a limited set of tools, keeping it focused on one job.