diff --git a/!/slider/boris-slider.gif b/!/root/boris-slider.gif similarity index 100% rename from !/slider/boris-slider.gif rename to !/root/boris-slider.gif diff --git a/!/root/github-trending.png b/!/root/github-trending.png new file mode 100644 index 0000000..5b84b89 Binary files /dev/null and b/!/root/github-trending.png differ diff --git a/README.md b/README.md index ef3866b..867e8a6 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,7 @@ practice makes claude perfect

- Boris Cherny on Claude Code
+ Boris Cherny on Claude Code
Boris Cherny on X (tweet 1 · tweet 2 · tweet 3)

@@ -223,5 +223,10 @@ claude | [LLM Day-to-Day Degradation](reports/llm-day-to-day-degradation.md) | Why LLM performance varies day-to-day — infrastructure bugs, MoE routing variance, and psychology | | [Agents vs Commands vs Skills](reports/claude-agent-command-skill.md) | When to use each extension mechanism — comparison table, resolution order, and worked example | +

+ GitHub Trending
+ ✨Trending on Github in March 2026✨ +

+ [![Claude for OSS](!/tags/claude-for-oss.svg)](https://claude.com/contact-sales/claude-for-oss) [![Claude Community Ambassador](!/tags/claude-community-ambassador.svg)](https://claude.com/community/ambassadors) diff --git a/best-practice/claude-commands.md b/best-practice/claude-commands.md index 4aab838..655fa67 100644 --- a/best-practice/claude-commands.md +++ b/best-practice/claude-commands.md @@ -1,6 +1,6 @@ # Commands Best Practice -![Last Updated](https://img.shields.io/badge/Last_Updated-Mar%2013%2C%202026-white?style=flat&labelColor=555)
+![Last Updated](https://img.shields.io/badge/Last_Updated-Mar%2013%2C%202026%204%3A47%20PM%20PKT-white?style=flat&labelColor=555)
[![Implemented](https://img.shields.io/badge/Implemented-2ea44f?style=flat)](../implementation/claude-commands-implementation.md) Claude Code commands — frontmatter fields and official built-in slash commands. @@ -25,32 +25,32 @@ Claude Code commands — frontmatter fields and official built-in slash commands --- -## ![Official](../!/tags/official.svg) **(56)** +## ![Official](../!/tags/official.svg) **(60)** | # | Command | Tag | Description | |---|---------|-----|-------------| | 1 | `/login` | ![Auth](https://img.shields.io/badge/Auth-2980B9?style=flat) | Authenticate with Claude Code via OAuth | | 2 | `/logout` | ![Auth](https://img.shields.io/badge/Auth-2980B9?style=flat) | Log out from Claude Code | -| 3 | `/config` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Open the interactive settings interface with search | -| 4 | `/keybindings` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Customize keyboard shortcuts per context and create chord sequences | -| 5 | `/output-style` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Pick an output style preset | +| 3 | `/upgrade` | ![Auth](https://img.shields.io/badge/Auth-2980B9?style=flat) | Open the upgrade page to switch to a higher plan tier | +| 4 | `/config` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Open the interactive settings interface with search | +| 5 | `/keybindings` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Customize keyboard shortcuts per context and create chord sequences | | 6 | `/permissions` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | View or update tool permissions | | 7 | `/privacy-settings` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Manage privacy and telemetry preferences | | 8 | `/sandbox` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Configure sandboxing with dependency status | | 9 | `/statusline` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Set up Claude Code's status line UI | -| 10 | `/stickers` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Choose sticker packs shown in the UI | +| 10 | `/stickers` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Order Claude Code stickers | | 11 | `/terminal-setup` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Enable shift+enter for newlines in IDE terminals | | 12 | `/theme` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Change the color theme | | 13 | `/vim` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Enable vim-style editing mode | | 14 | `/context` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Visualize current context usage as a colored grid with token counts | | 15 | `/cost` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Show token usage statistics for the current session | | 16 | `/extra-usage` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Configure pay-as-you-go overflow billing for subscription plans | -| 17 | `/status` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Show a concise session status summary | +| 17 | `/insights` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Generate a report analyzing your Claude Code sessions, including project areas, interaction patterns, and friction points | | 18 | `/stats` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Visualize daily usage, session history, streaks, and model preferences | -| 19 | `/usage` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Show plan usage limits and rate limit status (subscription plans only) | -| 20 | `/bug [description]` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | Alias for `/feedback` | +| 19 | `/status` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Show a concise session status summary | +| 20 | `/usage` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Show plan usage limits and rate limit status (subscription plans only) | | 21 | `/doctor` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | Check the health of your Claude Code installation | -| 22 | `/feedback [description]` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | Generate a GitHub issue URL for reporting bugs or feedback | +| 22 | `/feedback [description]` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | Generate a GitHub issue URL for reporting bugs or feedback. Alias: `/bug` | | 23 | `/help` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | Show slash-command help | | 24 | `/release-notes` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | Show recent Claude Code release notes | | 25 | `/tasks` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | List and manage background tasks | @@ -58,33 +58,37 @@ Claude Code commands — frontmatter fields and official built-in slash commands | 27 | `/export [filename]` | ![Export](https://img.shields.io/badge/Export-7F8C8D?style=flat) | Export the current conversation to a file or clipboard | | 28 | `/agents` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Manage custom subagents — view, create, edit, delete | | 29 | `/chrome` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Manage Claude in Chrome browser integration | -| 30 | `/ide` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Connect to IDE integration | -| 31 | `/mcp` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Manage MCP server connections | -| 32 | `/reload-plugins` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Reload installed plugins without restarting | -| 33 | `/memory` | ![Memory](https://img.shields.io/badge/Memory-3498DB?style=flat) | View and edit memory files | -| 34 | `/fast` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Toggle fast mode — same Opus 4.6 model with faster output | -| 35 | `/model` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Switch models (haiku, sonnet, opus) and adjust effort level | -| 36 | `/passes [number]` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Set the number of review passes for certain workflows | -| 37 | `/plan` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Enter read-only planning mode — suggests approaches without making changes | -| 38 | `/add-dir` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Add additional working directories to the current session | -| 39 | `/diff` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Review the current git diff in the active repo | -| 40 | `/init [prompt]` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Initialize a new project with a CLAUDE.md guide | -| 41 | `/pr-comments` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Review or reply to pull-request comments | -| 42 | `/review` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Review the current code changes | -| 43 | `/security-review` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Run a focused security review on current changes | -| 44 | `/desktop` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Connect to or manage the desktop companion app | -| 45 | `/install-github-app` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Install the GitHub app for PR-linked workflows | -| 46 | `/install-slack-app` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Install the Slack app for notifications and sharing | -| 47 | `/mobile` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Connect to or manage the mobile companion app | -| 48 | `/remote-control` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Continue the current session from another device | -| 49 | `/remote-env` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Inspect or copy the remote-control environment setup | -| 50 | `/clear` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Clear conversation history and start fresh | -| 51 | `/compact [prompt]` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Compress conversation to free context window. Optional prompt focuses the compaction | -| 52 | `/exit` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Exit the REPL | -| 53 | `/fork` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Fork the current conversation into a new session | -| 54 | `/rename ` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Rename the current session for easier identification | -| 55 | `/resume [session]` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Resume a previous conversation by ID or name, or open the session picker | -| 56 | `/rewind` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Rewind conversation and/or code to an earlier point | +| 30 | `/hooks` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Manage hook configurations for tool events | +| 31 | `/ide` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Connect to IDE integration | +| 32 | `/mcp` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Manage MCP server connections | +| 33 | `/plugin` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Manage Claude Code plugins | +| 34 | `/reload-plugins` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Reload installed plugins without restarting | +| 35 | `/skills` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | List available skills | +| 36 | `/memory` | ![Memory](https://img.shields.io/badge/Memory-3498DB?style=flat) | View and edit memory files | +| 37 | `/fast` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Toggle fast mode — same Opus 4.6 model with faster output | +| 38 | `/model` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Switch models (haiku, sonnet, opus) and adjust effort level | +| 39 | `/passes [number]` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Share a free week of Claude Code with friends. Only visible if your account is eligible | +| 40 | `/plan` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Enter read-only planning mode — suggests approaches without making changes | +| 41 | `/add-dir` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Add additional working directories to the current session | +| 42 | `/diff` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Review the current git diff in the active repo | +| 43 | `/init [prompt]` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Initialize a new project with a CLAUDE.md guide | +| 44 | `/pr-comments` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Review or reply to pull-request comments | +| 45 | `/review` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Deprecated — install the `code-review` plugin instead | +| 46 | `/security-review` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Run a focused security review on current changes | +| 47 | `/desktop` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Connect to or manage the desktop companion app | +| 48 | `/install-github-app` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Install the GitHub app for PR-linked workflows | +| 49 | `/install-slack-app` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Install the Slack app for notifications and sharing | +| 50 | `/mobile` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Connect to or manage the mobile companion app | +| 51 | `/remote-control` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Continue the current session from another device | +| 52 | `/remote-env` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Inspect or copy the remote-control environment setup | +| 53 | `/btw ` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Ask a quick side question without adding to the conversation | +| 54 | `/clear` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Clear conversation history and start fresh | +| 55 | `/compact [prompt]` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Compress conversation to free context window. Optional prompt focuses the compaction | +| 56 | `/exit` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Exit the REPL | +| 57 | `/fork` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Fork the current conversation into a new session | +| 58 | `/rename ` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Rename the current session for easier identification | +| 59 | `/resume [session]` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Resume a previous conversation by ID or name, or open the session picker | +| 60 | `/rewind` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Rewind conversation and/or code to an earlier point | Bundled skills such as `/debug` can also appear in the slash-command menu, but they are not built-in commands. diff --git a/best-practice/claude-skills.md b/best-practice/claude-skills.md index 77c4bbd..d341bac 100644 --- a/best-practice/claude-skills.md +++ b/best-practice/claude-skills.md @@ -1,6 +1,6 @@ # Skills Best Practice -![Last Updated](https://img.shields.io/badge/Last_Updated-Mar%2013%2C%202026-white?style=flat&labelColor=555)
+![Last Updated](https://img.shields.io/badge/Last_Updated-Mar%2013%2C%202026%204%3A22%20PM%20PKT-white?style=flat&labelColor=555)
[![Implemented](https://img.shields.io/badge/Implemented-2ea44f?style=flat)](../implementation/claude-skills-implementation.md) Claude Code skills — frontmatter fields and official bundled skills. @@ -31,7 +31,7 @@ Claude Code skills — frontmatter fields and official bundled skills. --- -## ![Official](../!/tags/official.svg) **(6)** +## ![Official](../!/tags/official.svg) **(5)** | # | Skill | Description | |---|-------|-------------| @@ -40,7 +40,6 @@ Claude Code skills — frontmatter fields and official bundled skills. | 3 | `debug` | Debug failing commands or code issues | | 4 | `loop` | Run a prompt or slash command on a recurring interval (up to 3 days) | | 5 | `claude-api` | Build apps with the Claude API or Anthropic SDK — triggers on `anthropic` / `@anthropic-ai/sdk` imports | -| 6 | `keybindings-help` | Customize keyboard shortcuts, rebind keys, and create chord sequences | See also: [Official Skills Repository](https://github.com/anthropics/skills/tree/main/skills) for community-maintained installable skills. diff --git a/best-practice/claude-subagents.md b/best-practice/claude-subagents.md index 75719ea..46c0c52 100644 --- a/best-practice/claude-subagents.md +++ b/best-practice/claude-subagents.md @@ -1,6 +1,6 @@ # Sub-agents Best Practice -![Last Updated](https://img.shields.io/badge/Last_Updated-Mar%2012%2C%202026%2012%3A17%20PM%20PKT-white?style=flat&labelColor=555)
+![Last Updated](https://img.shields.io/badge/Last_Updated-Mar%2013%2C%202026%204%3A21%20PM%20PKT-white?style=flat&labelColor=555)
[![Implemented](https://img.shields.io/badge/Implemented-2ea44f?style=flat)](../implementation/claude-subagents-implementation.md) Claude Code subagents — frontmatter fields and official built-in agent types. diff --git a/changelog/best-practice/claude-commands/changelog.md b/changelog/best-practice/claude-commands/changelog.md new file mode 100644 index 0000000..6e85f64 --- /dev/null +++ b/changelog/best-practice/claude-commands/changelog.md @@ -0,0 +1,33 @@ +# Commands Report — Changelog History + +## Status Legend + +| Status | Meaning | +|--------|---------| +| COMPLETE (reason) | Action was taken and resolved successfully | +| INVALID (reason) | Finding was incorrect, not applicable, or intentional | +| ON HOLD (reason) | Action deferred — waiting on external dependency or user decision | + +--- + +## [2026-03-13 04:23 PM PKT] Claude Code v2.1.74 + +| # | Priority | Type | Action | Status | +|---|----------|------|--------|--------| +| 1 | HIGH | New Field | Add `name` to frontmatter table — display name for the skill | INVALID (skill-only field, not applicable to commands frontmatter) | +| 2 | HIGH | New Field | Add `disable-model-invocation` to frontmatter table — prevents auto-loading | INVALID (skill-only field, not applicable to commands frontmatter) | +| 3 | HIGH | New Field | Add `user-invocable` to frontmatter table — hides from `/` menu | INVALID (skill-only field, not applicable to commands frontmatter) | +| 4 | HIGH | New Field | Add `context` to frontmatter table — fork to run in subagent context | INVALID (skill-only field, not applicable to commands frontmatter) | +| 5 | HIGH | New Field | Add `agent` to frontmatter table — subagent type for context: fork | INVALID (skill-only field, not applicable to commands frontmatter) | +| 6 | HIGH | New Field | Add `hooks` to frontmatter table — lifecycle hooks scoped to skill | INVALID (skill-only field, not applicable to commands frontmatter) | +| 7 | HIGH | New Command | Add `/btw ` — ask a quick side question without adding to conversation | COMPLETE (added as #53 in Session tag) | +| 8 | HIGH | New Command | Add `/hooks` — manage hook configurations for tool events | COMPLETE (added as #30 in Extensions tag) | +| 9 | HIGH | New Command | Add `/insights` — generate session analysis report | COMPLETE (added as #17 in Context tag) | +| 10 | HIGH | New Command | Add `/plugin` — manage Claude Code plugins | COMPLETE (added as #33 in Extensions tag) | +| 11 | HIGH | New Command | Add `/skills` — list available skills | COMPLETE (added as #35 in Extensions tag) | +| 12 | HIGH | New Command | Add `/upgrade` — open upgrade page to switch plan tier | COMPLETE (added as #3 in Auth tag) | +| 13 | HIGH | Removed Command | Remove `/output-style` — deprecated in v2.1.73, use `/config` instead | COMPLETE (removed from Config tag) | +| 14 | HIGH | Removed Command | Remove `/bug` row — now listed as alias under `/feedback` | COMPLETE (removed row, added "Alias: /bug" to /feedback description) | +| 15 | HIGH | Changed Description | Update `/passes` — repurposed from review passes to referral sharing | COMPLETE (updated description, kept in Model tag) | +| 16 | HIGH | Changed Description | Update `/review` — deprecated, replaced by `code-review` marketplace plugin | COMPLETE (updated description in Project tag) | +| 17 | MED | Changed Description | Update `/stickers` — changed from UI sticker packs to ordering physical stickers | COMPLETE (updated description in Config tag) | diff --git a/changelog/best-practice/claude-skills/changelog.md b/changelog/best-practice/claude-skills/changelog.md new file mode 100644 index 0000000..47121ba --- /dev/null +++ b/changelog/best-practice/claude-skills/changelog.md @@ -0,0 +1,17 @@ +# Skills Report Changelog + +**Status Legend:** + +| Status | Meaning | +|--------|---------| +| `COMPLETE (reason)` | Action was taken and resolved successfully | +| `INVALID (reason)` | Finding was incorrect, not applicable, or intentional | +| `ON HOLD (reason)` | Action deferred, waiting on external dependency or user decision | + +--- + +## [2026-03-13 04:22 PM PKT] Claude Code v2.1.74 + +| # | Priority | Type | Action | Status | +|---|----------|------|--------|--------| +| 1 | MED | Extra Bundled Skill | `keybindings-help` is in local report but absent from official docs bundled skills list — investigate whether to remove or keep | COMPLETE (removed from bundled skills table — it is a local custom skill in this repo, not an official bundled skill; `/keybindings` is a built-in CLI command) | diff --git a/changelog/best-practice/claude-subagents/changelog.md b/changelog/best-practice/claude-subagents/changelog.md index eccfc98..bdf4bac 100644 --- a/changelog/best-practice/claude-subagents/changelog.md +++ b/changelog/best-practice/claude-subagents/changelog.md @@ -44,3 +44,9 @@ ## [2026-03-12 12:17 PM PKT] Claude Code v2.1.74 No drift detected — report is fully in sync with official docs. All 13 frontmatter fields and 6 built-in agents match. + +--- + +## [2026-03-13 04:21 PM PKT] Claude Code v2.1.74 + +No drift detected — report is fully in sync with official docs. All 13 frontmatter fields and 6 built-in agents match.