编程开发来源：GitHub 协议：MIT 协议已标注

claude-code-best-practice

汇总 Claude Code 的浏览器操作、上下文控制和工程执行最佳实践。

65.6K GitHub stars 2026-09-05 星标同步 2026-07-16 收录时间

#claude-code#best-practices#browser

快速判断

01这个 Skill 是干嘛的: 汇总浏览器操作、上下文控制、任务执行和调试等 Claude Code 实践。
02它能解决什么问题: 解决新用户不会组织会话、工具使用低效和长任务容易失去上下文的问题。
03它适合谁来用: 适合希望系统提升 Claude Code 使用效率的个人开发者。

claude-code-best-practice

汇总 Claude Code 的浏览器操作、上下文控制和工程执行最佳实践。

主要能力

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.

使用方式

仓库级安装会保留完整目录；本次核验的入口是 .claude/skills/agent-browser/SKILL.md。使用前先阅读英文 README 与原始 SKILL.md，并按当前 Agent 的目录规范安装。

适用边界

部分流程依赖具体工具能力，换用其他 Agent 时要逐项核对兼容性。

许可与来源

来源：GitHub 公开仓库。核验许可：MIT。本页是贴近原仓库结构的中文导读，具体参数、依赖和更新记录以英文 README 为准。

claude-code-best-practice

from vibe coding to agentic engineering - practice makes claude perfect

Click on these badges below to see the actual sources <img src="!/tags/a.svg" height="14"> = Agents · <img src="!/tags/c.svg" height="14"> = Commands · <img src="!/tags/s.svg" height="14"> = Skills

<img src="!/root/boris-slider.gif" alt="Boris Cherny on Claude Code" width="600"> Boris Cherny on X (<a href="https://x.com/bcherny/status/2007179832300581177">tweet 1</a> · <a href="https://x.com/bcherny/status/2017742741636321619">tweet 2</a> · <a href="https://x.com/bcherny/status/2021699851499798911">tweet 3</a>)

[!TIP] Visit the How to Use section to take full advantage of this repo.

🧠 CONCEPTS

Feature	Location	Description
<img src="!/tags/a.svg" height="14"> Subagents	`.claude/agents/<name>.md`
<img src="!/tags/c.svg" height="14"> Commands	`.claude/commands/<name>.md`
<img src="!/tags/s.svg" height="14"> Skills	`.claude/skills/<name>/SKILL.md`	Official Skills · Skills for Mono-repos
Workflows	`.claude/commands/weather-orchestrator.md`
Hooks	`.claude/hooks/`	Guide
MCP Servers	`.claude/settings.json`, `.mcp.json`
Plugins	distributable packages	Marketplaces · Create Marketplaces
Settings	`.claude/settings.json`	Permissions · Model Config · Output Styles · Sandboxing · Keybindings · Auto Mode Config
Status Line	`.claude/settings.json`
Memory	`CLAUDE.md`, `.claude/rules/`, `~/.claude/rules/`, `~/.claude/projects/<project>/memory/`	Auto Memory · Auto Memory Deep-dive · Rules
Checkpointing	automatic (file-edit tracking)
CLI Startup Flags	`claude [flags]`	Interactive Mode · Env Vars
AI Terms
Best Practices		Prompt Engineering · Extend Claude Code

🔥 Hot

Feature	Location	Description
Ultrareview	`/code-review ultra`, `claude ultrareview [target]`	Tasks tracking
Devcontainers	`.devcontainer/`
Channels	`--channels`, plugin-based	Reference
Ultraplan	`/ultraplan`
No Flicker Mode	`/tui fullscreen`, `CLAUDE_CODE_NO_FLICKER=1`
Auto Mode	`--permission-mode auto`, `Shift+Tab`	Blog
Power-ups	`/powerup`
Fast Mode	`/fast`, `"fastMode": true`
Advisor	`/advisor`, `advisorModel`, `--advisor`	Blog
Computer Use	`computer-use` MCP server	Desktop
Agent SDK	`npm` / `pip` package	Quickstart · Examples
Ralph Wiggum Loop	plugin
Chrome	`--chrome`, extension
Claude Code Web	`claude.ai/code`	Routines
Artifacts	`/share`, `Artifact` tool
Slack	`@Claude` in Slack
Code Review	GitHub App (managed)	Blog Local /code-review
GitHub Actions	`.github/workflows/`	GitLab CI/CD
Remote Control	`/remote-control`, `/rc`	Headless Mode
Deep Links	`claude-cli://open?repo=…&q=…`
Dynamic Workflows	`/workflows`, `ultracode` keyword, `/effort ultracode`, `.claude/workflows/`	Deep Research
Agent Teams	built-in (env var)
Agent View	`claude agents`, `--bg`, `/bg`
Scheduled Tasks	`/loop`, `/schedule`, cron tools	Desktop scheduled tasks · Announcement
Routines	`claude.ai/code/routines`, `/schedule`	Desktop Tasks
Tasks	`/tasks`, `~/.claude/tasks/`	Ultrareview tracking
Goal	`/goal <condition>`, `/goal clear`
Voice Dictation	`/voice`
Bundled Skills	`/code-review`, `/batch`
Git Worktrees	`--worktree`/`-w`, `.worktreeinclude`, `EnterWorktree`/`ExitWorktree`, `isolation: "worktree"`, `WorktreeCreate`/`WorktreeRemove` hooks

<a href="orchestration-workflow/orchestration-workflow.md"><img src="!/tags/orchestration-workflow-hd.svg" alt="Orchestration Workflow"></a>

See orchestration-workflow for implementation details of <img src="!/tags/c.svg" height="14"> Command → <img src="!/tags/a.svg" height="14"> Agent → <img src="!/tags/s.svg" height="14"> Skill pattern.

How to Use

claude
/weather-orchestrator

⚙️ DEVELOPMENT WORKFLOWS

All major workflows converge on the same architectural pattern: Research → Plan → Execute → Review → Ship

Name	★	Workflow	<img src="!/tags/a.svg" height="14">	<img src="!/tags/c.svg" height="14">	<img src="!/tags/s.svg" height="14">
Superpowers	255k	<img src="https://img.shields.io/badge/brainstorming-ddf4ff" alt="brainstorming" align="middle"> → <img src="https://img.shields.io/badge/using--git--worktrees-ddf4ff" alt="using-git-worktrees" align="middle"> → <img src="https://img.shields.io/badge/writing--plans-ddf4ff" alt="writing-plans" align="middle"> → <img src="https://img.shields.io/badge/subagent--driven--development-ddf4ff" alt="subagent-driven-development" align="middle"> → <img src="https://img.shields.io/badge/dispatching--parallel--agents-fff3b0" alt="dispatching-parallel-agents" align="middle"> → <img src="https://img.shields.io/badge/executing--plans-fff3b0" alt="executing-plans" align="middle"> → <img src="https://img.shields.io/badge/test--driven--development-fff3b0" alt="test-driven-development" align="middle"> → <img src="https://img.shields.io/badge/verification--before--completion-fff3b0" alt="verification-before-completion" align="middle"> → <img src="https://img.shields.io/badge/requesting--code--review-ddf4ff" alt="requesting-code-review" align="middle"> → <img src="https://img.shields.io/badge/finishing--a--development--branch-ddf4ff" alt="finishing-a-development-branch" align="middle">	0	0	14
Everything Claude Code	230k	<img src="https://img.shields.io/badge/plan-ddf4ff" alt="plan" align="middle"> → <img src="https://img.shields.io/badge/plan--prd-ddf4ff" alt="plan-prd" align="middle"> → <img src="https://img.shields.io/badge/prp--implement-fff3b0" alt="prp-implement" align="middle"> → <img src="https://img.shields.io/badge/code--review-fff3b0" alt="code-review" align="middle"> → <img src="https://img.shields.io/badge/build--fix-fff3b0" alt="build-fix" align="middle"> → <img src="https://img.shields.io/badge/e2e--testing-ddf4ff" alt="e2e-testing" align="middle"> → <img src="https://img.shields.io/badge/prp--pr-ddf4ff" alt="prp-pr" align="middle">	67	139	278
Matt Pocock Skills	171k	<img src="https://img.shields.io/badge/ask--matt-ddf4ff" alt="ask-matt" align="middle"> → <img src="https://img.shields.io/badge/grill--with--docs-ddf4ff" alt="grill-with-docs" align="middle"> → <img src="https://img.shields.io/badge/grill--me-fff3b0" alt="grill-me" align="middle"> → <img src="https://img.shields.io/badge/to--spec-ddf4ff" alt="to-spec" align="middle"> → <img src="https://img.shields.io/badge/to--tickets-ddf4ff" alt="to-tickets" align="middle"> → <img src="https://img.shields.io/badge/tdd-fff3b0" alt="tdd" align="middle"> → <img src="https://img.shields.io/badge/prototype-fff3b0" alt="prototype" align="middle"> → <img src="https://img.shields.io/badge/diagnosing--bugs-fff3b0" alt="diagnosing-bugs" align="middle"> → <img src="https://img.shields.io/badge/implement-ddf4ff" alt="implement" align="middle"> → <img src="https://img.shields.io/badge/code--review-ddf4ff" alt="code-review" align="middle"> → <img src="https://img.shields.io/badge/improve--codebase--architecture-ddf4ff" alt="improve-codebase-architecture" align="middle">	0	0	40
gstack	122k	<img src="https://img.shields.io/badge/%2Foffice--hours-ddf4ff" alt="/office-hours" align="middle"> → <img src="https://img.shields.io/badge/%2Fplan--ceo--review-ddf4ff" alt="/plan-ceo-review" align="middle"> → <img src="https://img.shields.io/badge/%2Fplan--eng--review-ddf4ff" alt="/plan-eng-review" align="middle"> → <img src="https://img.shields.io/badge/%2Fplan--devex--review-ddf4ff" alt="/plan-devex-review" align="middle"> → <img src="https://img.shields.io/badge/%2Fplan--design--review-ddf4ff" alt="/plan-design-review" align="middle"> → <img src="https://img.shields.io/badge/%2Freview-ddf4ff" alt="/review" align="middle"> → <img src="https://img.shields.io/badge/%2Fqa-ddf4ff" alt="/qa" align="middle"> → <img src="https://img.shields.io/badge/%2Fship-ddf4ff" alt="/ship" align="middle"> → <img src="https://img.shields.io/badge/%2Fland--and--deploy-ddf4ff" alt="/land-and-deploy" align="middle">	0	0	61
Spec Kit	121k	<img src="https://img.shields.io/badge/%2Fspeckit.constitution-ddf4ff" alt="/speckit.constitution" align="middle"> → <img src="https://img.shields.io/badge/%2Fspeckit.specify-ddf4ff" alt="/speckit.specify" align="middle"> → <img src="https://img.shields.io/badge/%2Fspeckit.clarify-fff3b0" alt="/speckit.clarify" align="middle"> → <img src="https://img.shields.io/badge/%2Fspeckit.plan-ddf4ff" alt="/speckit.plan" align="middle"> → <img src="https://img.shields.io/badge/%2Fspeckit.tasks-ddf4ff" alt="/speckit.tasks" align="middle"> → <img src="https://img.shields.io/badge/%2Fspeckit.analyze-fff3b0" alt="/speckit.analyze" align="middle"> → <img src="https://img.shields.io/badge/%2Fspeckit.implement-ddf4ff" alt="/speckit.implement" align="middle"> → <img src="https://img.shields.io/badge/%2Fspeckit.converge-fff3b0" alt="/speckit.converge" align="middle"> → <img src="https://img.shields.io/badge/%2Fspeckit.checklist-ddf4ff" alt="/speckit.checklist" align="middle">	0	10	0
agent-skills	69k	<img src="https://img.shields.io/badge/%2Fspec-ddf4ff" alt="/spec" align="middle"> → <img src="https://img.shields.io/badge/%2Fplan-ddf4ff" alt="/plan" align="middle"> → <img src="https://img.shields.io/badge/%2Fbuild-ddf4ff" alt="/build" align="middle"> → <img src="https://img.shields.io/badge/%2Ftest-ddf4ff" alt="/test" align="middle"> → <img src="https://img.shields.io/badge/%2Freview-ddf4ff" alt="/review" align="middle"> → <img src="https://img.shields.io/badge/%2Fship-ddf4ff" alt="/ship" align="middle">	3	7	21
Get Shit Done	65k	<img src="https://img.shields.io/badge/%2Fgsd--new--project-ddf4ff" alt="/gsd-new-project" align="middle"> → <img src="https://img.shields.io/badge/%2Fgsd--discuss--phase-ddf4ff" alt="/gsd-discuss-phase" align="middle"> → <img src="https://img.shields.io/badge/%2Fgsd--plan--phase-ddf4ff" alt="/gsd-plan-phase" align="middle"> → <img src="https://img.shields.io/badge/%2Fgsd--execute--phase-fff3b0" alt="/gsd-execute-phase" align="middle"> → <img src="https://img.shields.io/badge/%2Fgsd--verify--work-ddf4ff" alt="/gsd-verify-work" align="middle"> → <img src="https://img.shields.io/badge/%2Fgsd--ship-ddf4ff" alt="/gsd-ship" align="middle">	33	67	0
OpenSpec	61k	<img src="https://img.shields.io/badge/%2Fopsx:propose-ddf4ff" alt="/opsx:propose" align="middle"> → <img src="https://img.shields.io/badge/%2Fopsx:explore-ddf4ff" alt="/opsx:explore" align="middle"> → <img src="https://img.shields.io/badge/%2Fopsx:new-ddf4ff" alt="/opsx:new" align="middle"> → <img src="https://img.shields.io/badge/%2Fopsx:ff-fff3b0" alt="/opsx:ff" align="middle"> → <img src="https://img.shields.io/badge/%2Fopsx:apply-ddf4ff" alt="/opsx:apply" align="middle"> → <img src="https://img.shields.io/badge/%2Fopsx:update-fff3b0" alt="/opsx:update" align="middle"> → <img src="https://img.shields.io/badge/%2Fopsx:sync-ddf4ff" alt="/opsx:sync" align="middle"> → <img src="https://img.shields.io/badge/%2Fopsx:verify-fff3b0" alt="/opsx:verify" align="middle"> → <img src="https://img.shields.io/badge/%2Fopsx:archive-ddf4ff" alt="/opsx:archive" align="middle">	0	12	0
BMAD-METHOD	51k	<img src="https://img.shields.io/badge/bmad--brainstorming-ddf4ff" alt="bmad-brainstorming" align="middle"> → <img src="https://img.shields.io/badge/bmad--prfaq-ddf4ff" alt="bmad-prfaq" align="middle"> → <img src="https://img.shields.io/badge/bmad--prd-ddf4ff" alt="bmad-prd" align="middle"> → <img src="https://img.shields.io/badge/bmad--ux-ddf4ff" alt="bmad-ux" align="middle"> → <img src="https://img.shields.io/badge/bmad--technical--research-ddf4ff" alt="bmad-technical-research" align="middle"> → <img src="https://img.shields.io/badge/bmad--generate--project--context-ddf4ff" alt="bmad-generate-project-context" align="middle"> → <img src="https://img.shields.io/badge/bmad--create--story-ddf4ff" alt="bmad-create-story" align="middle"> → <img src="https://img.shields.io/badge/bmad--dev--auto-fff3b0" alt="bmad-dev-auto" align="middle"> → <img src="https://img.shields.io/badge/bmad--review--edge--case--hunter-fff3b0" alt="bmad-review-edge-case-hunter" align="middle">	6	0	47
oh-my-claudecode	38k	<img src="https://img.shields.io/badge/deepinit-ddf4ff" alt="deepinit" align="middle"> → <img src="https://img.shields.io/badge/plan-ddf4ff" alt="plan" align="middle"> → <img src="https://img.shields.io/badge/ultrawork-fff3b0" alt="ultrawork" align="middle"> → <img src="https://img.shields.io/badge/ultraqa-fff3b0" alt="ultraqa" align="middle"> → <img src="https://img.shields.io/badge/verify-fff3b0" alt="verify" align="middle"> → <img src="https://img.shields.io/badge/release-ddf4ff" alt="release" align="middle">	19	0	41
Compound Engineering	23k	<img src="https://img.shields.io/badge/%2Fce--brainstorm-ddf4ff" alt="/ce-brainstorm" align="middle"> → <img src="https://img.shields.io/badge/%2Fce--plan-ddf4ff" alt="/ce-plan" align="middle"> → <img src="https://img.shields.io/badge/%2Fce--work-ddf4ff" alt="/ce-work" align="middle"> → <img src="https://img.shields.io/badge/%2Fce--simplify--code-fff3b0" alt="/ce-simplify-code" align="middle"> → <img src="https://img.shields.io/badge/%2Fce--code--review-ddf4ff" alt="/ce-code-review" align="middle"> → <img src="https://img.shields.io/badge/%2Fce--compound-ddf4ff" alt="/ce-compound" align="middle">	0	1	30
HumanLayer	11k	<img src="https://img.shields.io/badge/%2Fralph__research-fff3b0" alt="/ralph_research" align="middle"> → <img src="https://img.shields.io/badge/%2Fcreate__plan-ddf4ff" alt="/create_plan" align="middle"> → <img src="https://img.shields.io/badge/%2Fiterate__plan-fff3b0" alt="/iterate_plan" align="middle"> → <img src="https://img.shields.io/badge/%2Fvalidate__plan-ddf4ff" alt="/validate_plan" align="middle"> → <img src="https://img.shields.io/badge/%2Fimplement__plan-ddf4ff" alt="/implement_plan" align="middle"> → <img src="https://img.shields.io/badge/%2Fdescribe__pr-ddf4ff" alt="/describe_pr" align="middle"> → <img src="https://img.shields.io/badge/%2Fcommit-ddf4ff" alt="/commit" align="middle">	6	27	0

Note: yellow tags are sub-loops — steps that repeat inside a parent step (e.g. per task, per story, or until a verify condition passes).

Others

RPI
Ralph Wiggum Loop
Andrej Karpathy (Founding Member, OpenAI) Workflow
Peter Steinberger (Creator of OpenClaw) Workflow
Boris Cherny (Creator of Claude Code) Workflow — 13 Tips · 10 Tips · 12 Tips · 2 Tips · 15 Tips · 6 Tips
Thariq (Anthropic) Workflow — Skills · Session Management

🔀 CROSS-MODEL WORKFLOWS

Use Claude Code together with other models — Codex, Gemini, GPT, Kimi, DeepSeek, local — via three mechanisms:

Plugin — another model's CLI runs inside Claude Code (slash commands like /codex:review)
MCP — Claude Code calls another model as a tool through Model Context Protocol
Router — Claude Code's API endpoint is swapped to a different provider

Methodology: Cross-Model (Claude Code + Codex) Workflow — manual two-terminal flow with Plan in Claude, QA-Review in Codex.

Name	★	Type	Bridges to	What it does
musistudio/claude-code-router	34k	Router	OpenRouter, DeepSeek, Ollama, Gemini, Kimi, Qwen, Groq, +more	Routes Claude Code's API to any compatible provider, with per-task model selection
router-for-me/CLIProxyAPI	32k	Router	Gemini CLI, Codex, Claude Code, Antigravity	Wraps each CLI as an OpenAI/Gemini/Claude/Codex-compatible API service
openai/codex-plugin-cc	18k	Plugin	Codex / GPT-5	Official OpenAI plugin: `/codex:review`, `/codex:adversarial-review`, `/codex:rescue` inside Claude Code
BeehiveInnovations/pal-mcp-server	12k	MCP	Gemini, OpenAI, Azure, Grok, Ollama, OpenRouter (50+ models)	Multi-model MCP server (formerly `zen-mcp-server`) — call other models as Claude tools

🧰 SKILL COLLECTIONS

Repos primarily known as curated libraries of SKILL.md files (distinct from full workflow methodologies above). Sorted by stars descending.

Name	★	<img src="!/tags/s.svg" height="14">
mattpocock/skills	169k	35
anthropics/skills	161k	17
Egonex-AI/Understand-Anything	67k	8
wshobson/agents	38k	162
scientific-agent-skills	31k	149
awesome-agent-skills	28k	1,497+ (curated list)
impeccable	27k	1 (with 7 design domain references)
agent-skills	27k	21
claude-skills	15k	246 (across 9 domains)
shanraisshan/draw-json-architecture-skill	3	1

🤖 AGENT COLLECTIONS

Repos primarily known as curated libraries of subagent definitions (.claude/agents/*.md). Sorted by stars descending.

Name	★	<img src="!/tags/a.svg" height="14">
msitarzewski/agency-agents	131k	254
VoltAgent/awesome-claude-code-subagents	23k	156

💡 TIPS AND TRICKS (83)

🚫👶 = do not babysit

Prompting · Planning · Context · Session · CLAUDE.md + .claude/rules · Agents · Commands · Skills · Hooks · Workflows · Advanced · Git / PR · Debugging · Utilities · Daily

Community

<a id="tips-prompting"></a>■ Prompting (3)

Tip	Source
challenge Claude — "grill me on these changes and don't make a PR until I pass your test." or "prove to me this works" and have Claude diff between main and your branch 🚫👶
after a mediocre fix — "knowing everything you know now, scrap this and implement the elegant solution" 🚫👶
Claude fixes most bugs by itself — paste the bug, say "fix", don't micromanage how 🚫👶

<a id="tips-planning"></a>■ Planning/Specs (7)

Tip	Source
always start with plan mode
start with a minimal spec or prompt and ask Claude to interview you using AskUserQuestion tool, then make a new session to execute the spec
always make a phase-wise gated plan, with each phase having multiple tests (unit, automation, integration)
break PRDs into vertical slices (tracer bullets) that cross all layers (DB + service + UI) — AI defaults to horizontal phasing (DB phase, then API phase, then frontend phase) which delays end-to-end feedback until the last phase. From the Pragmatic Programmer 🚫👶
spin up a second Claude to review your plan as a staff engineer, or use cross-model for review
write detailed specs and reduce ambiguity before handing work off — the more specific you are, the better the output
prototype > PRD — build 20-30 versions instead of writing specs, the cost of building is low so take many shots

<a id="tips-context"></a>■ Context (5)

Tip	Source
context rot kicks in around ~300-400k tokens on the 1M context model — don't let sessions drift past that for intelligence-sensitive work
dumb zone kicks in around ~40% context — "you hit this point where you have degrading results". Newcomers: "shoot to keep it under 40%, and if you get up to 60%, think about wrapping it up". Experienced: "aggressively keep it below 30%" — push to 60% only on simple tasks. Manual /compact or /clear to reset when switching tasks
rewind > correct — double-Esc or /rewind back to before the failed attempt and re-prompt with what you learned, instead of leaving failed attempts + corrections polluting context 🚫👶
/compact with a hint (/compact focus on the auth refactor, drop the test debugging) beats letting autocompact fire — the model is at its least intelligent point when auto-compacting due to context rot
use subagents for context management — ask yourself "will I need this tool output again, or just the conclusion?" — 20 file reads + 12 greps + 3 dead ends stay in the child's context, only the final report returns 🚫👶

<a id="tips-session"></a>■ Session Management (6)

Tip	Source
every turn is a branching point — after Claude ends a turn, pick between Continue, /rewind, /clear, /compact, or Subagent based on how much existing context you need to carry forward
new task = new session — related tasks (e.g. writing docs for what you just built) can reuse context for efficiency, but genuinely new tasks deserve a fresh session
use "summarize from here" before rewinding to have Claude write a handoff message — like a note to the previous iteration of Claude from its future self
/compact vs /clear — compact is lossy but momentum-friendly (mid-task, fuzzy details ok); /clear + brief is more work but you control exactly what carries forward (high-stakes next step)
use recaps for long-running sessions — short summaries of what Claude did and what's next, useful when returning after minutes or hours. Disable with recaps in /config
/rename important sessions (e.g. [TODO - refactor task]) and /resume them later — label each instance when running multiple Claudes simultaneously

<a id="tips-claudemd"></a>■ CLAUDE.md + .claude/rules (8)

Tip	Source
CLAUDE.md should target under 200 lines per file. 60 lines in humanlayer (still not 100% guaranteed)
.claude/rules/*.md auto-load into every session like CLAUDE.md — add paths: YAML frontmatter to lazy-load them only when Claude touches files matching the glob
wrap domain-specific CLAUDE.md rules in \<important if="..."\> tags to stop Claude from ignoring them as files grow longer
use multiple CLAUDE.md for monorepos — ancestor + descendant loading
use .claude/rules/ to split large instructions
any developer should be able to launch Claude, say "run the tests" and it works on the first try — if it doesn't, your CLAUDE.md is missing essential setup/build/test commands
keep codebases clean and finish migrations — partially migrated frameworks confuse models that might pick the wrong pattern
use settings.json for harness-enforced behavior (attribution, permissions, model) — don't put "NEVER add Co-Authored-By" in CLAUDE.md when attribution.commit: "" is deterministic

<a id="tips-agents"></a><img src="!/tags/a.svg" height="14"> Agents (4)

Tip	Source
have feature specific sub-agents (extra context) with skills (progressive disclosure) instead of general qa, backend engineer
say "use subagents" to throw more compute at a problem — offload tasks to keep your main context clean and focused 🚫👶
agent teams with tmux and git worktrees for parallel development
use test time compute — separate context windows make results better; one agent can cause bugs and another (same model) can find them

<a id="tips-commands"></a><img src="!/tags/c.svg" height="14"> Commands (3)

Tip	Source
use commands for your workflows instead of sub-agents
use slash commands for every "inner loop" workflow you do many times a day — saves repeated prompting, commands live in .claude/commands/ and are checked into git
if you do something more than once a day, turn it into a skill or command — build /techdebt, context-dump, or analytics commands

<a id="tips-skills"></a><img src="!/tags/s.svg" height="14"> Skills (9)

Tip	Source
use context: fork to run a skill in an isolated subagent — main context only sees the final result, not intermediate tool calls. The agent field lets you set the subagent type
use skills in subfolders for monorepos
skills are folders, not files — use references/, scripts/, examples/ subdirectories for progressive disclosure
build a Gotchas section in every skill — highest-signal content, add Claude's failure points over time
skill description field is a trigger, not a summary — write it for the model ("when should I fire?")
don't state the obvious in skills — focus on what pushes Claude out of its default behavior 🚫👶
don't railroad Claude in skills — give goals and constraints, not prescriptive step-by-step instructions 🚫👶
include scripts and libraries in skills so Claude composes rather than reconstructs boilerplate
embed !command in SKILL.md to inject dynamic shell output into the prompt — Claude runs it on invocation and the model only sees the result

<a id="tips-hooks"></a>■ Hooks (5)

Tip	Source
use on-demand hooks in skills — /careful blocks destructive commands, /freeze blocks edits outside a directory
measure skill usage with a PreToolUse hook to find popular or undertriggering skills
use a PostToolUse hook to auto-format code — Claude generates well-formatted code, the hook handles the last 10% to avoid CI failures
route permission requests to Opus via a hook — let it scan for attacks and auto-approve safe ones 🚫👶
use a Stop hook to nudge Claude to keep going or verify its work at the end of a turn

<a id="tips-workflows"></a>■ Workflows (5)

Tip	Source
use /model to select model and reasoning, /context to see context usage, /usage to check plan limits, /extra-usage to configure overflow billing, /config to configure settings — use Opus for plan mode and Sonnet for code to get the best of both
always use thinking mode true (to see reasoning) and Output Style Explanatory (to see detailed output with ★ Insight boxes) in /config for better understanding of Claude's decisions
use ultrathink keyword in prompts for high effort reasoning
/focus mode hides all intermediate work and shows only the final result — trust the model to run the right commands and just look at the outcome (toggle with /focus)
tune effort level with Opus 4.7's adaptive thinking — low for speed and fewer tokens, max for most intelligence (slider: low · medium · high · xhigh · max)

<a id="tips-workflows-advanced"></a>■ Workflows Advanced (9)

Tip	Source
use ASCII diagrams a lot to understand your architecture
use /loop for local recurring monitoring (up to 7 days) · use /schedule for cloud-based recurring tasks that run even when your machine is off
use Ralph Wiggum plugin for long-running autonomous tasks
/permissions with wildcard syntax (Bash(npm run ), Edit(/docs/*)) instead of dangerously-skip-permissions
/sandbox to reduce permission prompts with file and network isolation — 84% reduction internally
invest in product verification skills (signup-flow-driver, checkout-verifier) — worth spending a week to perfect
use auto mode instead of dangerously-skip-permissions — a model-based classifier decides if each command is safe and auto-approves, pauses and asks if risky. Shift+Tab to cycle Ask → Plan → Auto modes 🚫👶
use /less-permission-prompts skill to scan session history for safe bash/MCP commands that repeatedly prompt, then get a recommended allowlist to paste into settings
build a /go skill that (1) tests end-to-end via bash/browser/computer use (2) runs /simplify (3) puts up a PR — so when you come back, you know the code works 🚫👶

<a id="tips-git-pr"></a>■ Git / PR (5)

Tip	Source
keep PRs small and focused — p50 of 118 lines (141 PRs, 45K lines changed in a day), one feature per PR, easier to review and revert
always squash merge PRs — clean linear history, one commit per feature, easy git revert and git bisect
commit often — try to commit at least once per hour, as soon as task is completed, commit
tag @claude on a coworker's PR to auto-generate lint rules for recurring review feedback — automate yourself out of code review 🚫👶
use /code-review for multi-agent PR analysis — catches bugs, security vulnerabilities, and regressions before merge

<a id="tips-debugging"></a>■ Debugging (6)

Tip	Source
make it a habit to take screenshots and share with Claude whenever you are stuck with any issue
use mcp (Claude in Chrome, Playwright, Chrome DevTools) to let claude see chrome console logs on its own
always ask claude to run the terminal (you want to see logs of) as a background task for better debugging
/doctor to diagnose installation, authentication, and configuration issues
use a cross-model for QA — e.g. Codex for plan and implementation review
agentic search (glob + grep) beats RAG — Claude Code tried and discarded vector databases because code drifts out of sync and permissions are complex

<a id="tips-utilities"></a>■ Utilities (5)

Tip	Source
iTerm/Ghostty/tmux terminals instead of IDE (VS Code/Cursor)
/voice or Wispr Flow for voice prompting (10x productivity)
claude-code-hooks for claude feedback
status line for context awareness and fast compacting
explore settings.json features like Plans Directory, Spinner Verbs for a personalized experience

<a id="tips-daily"></a>■ Daily (2)

Tip	Source
update Claude Code daily
start your day by reading the changelog

Boris Cherny + Team

Article / Tweet	Source
[6 Tips for Getting More Out of Opus 4.7 (Boris) \	16/Apr/26](tips/claude-boris-6-tips-16-apr-26.md)	Tweet
[Session Management & 1M Context (Thariq) \	16/Apr/26](tips/claude-thariq-tips-16-apr-26.md)	Tweet
[15 Hidden & Under-Utilized Features in Claude Code (Boris) \	30/Mar/26](tips/claude-boris-15-tips-30-mar-26.md)	Tweet
[Squash Merging & PR Size Distribution (Boris) \	25/Mar/26](tips/claude-boris-2-tips-25-mar-26.md)	Tweet
[Lessons from Building Claude Code: How We Use Skills (Thariq) \	17/Mar/26](tips/claude-thariq-tips-17-mar-26.md)	Article
[Code Review & Test Time Compute (Boris) \	10/Mar/26](tips/claude-boris-2-tips-10-mar-26.md)	Tweet
/loop — schedule recurring tasks for up to 3 days (Boris) \	07 Mar 2026	Tweet
AskUserQuestion + ASCII Markdowns (Thariq) \	28 Feb 2026	Tweet
Seeing like an Agent - lessons from building Claude Code (Thariq) \	28 Feb 2026	Article
Git Worktrees - 5 ways how boris is using \	21 Feb 2026	Tweet
Lessons from Building Claude Code: Prompt Caching Is Everything (Thariq) \	20 Feb 2026	Article
[12 ways how people are customizing their claudes (Boris) \	12/Feb/26](tips/claude-boris-12-tips-12-feb-26.md)	Tweet
[10 tips for using Claude Code from the team (Boris) \	01/Feb/26](tips/claude-boris-10-tips-01-feb-26.md)	Tweet
[How I use Claude Code — 13 tips from my surprisingly vanilla setup (Boris) \	03/Jan/26](tips/claude-boris-13-tips-03-jan-26.md)	Tweet
Ask Claude to interview you using AskUserQuestion tool (Thariq) \	28/Dec/25	Tweet
Always use plan mode, give Claude a way to verify, use /code-review (Boris) \	27/Dec/25	Tweet

Tips from Claude code CLI binary

Spinner Verbs & Tips (extracted from CLI binary v2.1.121)

🎬 VIDEOS / PODCASTS

Video / Podcast	Source	YouTube
From Vibe Coding to Agentic Engineering (Andrej) \	02 May 2026 \	AI Engineer	YouTube
Full Walkthrough: Workflow for AI Coding (Matt) \	24 Apr 2026 \	Matt Pocock	YouTube
Everything We Got Wrong About Research-Plan-Implement (Dex) \	24 Mar 2026 \	MLOps Community	YouTube
Building Claude Code with Boris Cherny (Boris) \	04 Mar 2026 \	The Pragmatic Engineer	YouTube
Head of Claude Code: What happens after coding is solved (Boris) \	19 Feb 2026 \	Lenny's Podcast	YouTube
Inside Claude Code With Its Creator Boris Cherny (Boris) \	17 Feb 2026 \	Y Combinator	YouTube
Boris Cherny (Creator of Claude Code) On What Grew His Career (Boris) \	15 Dec 2025 \	Ryan Peterman	YouTube
The Secrets of Claude Code From the Engineers Who Built It (Cat) \	29 Oct 2025 \	Every	YouTube

Source	Name	Badge
	r/ClaudeAI, r/ClaudeCode, r/Anthropic
	Claude, Claude Devs, Anthropic, Boris, Thariq, Cat, Lydia, Noah, Anthony, Alex, Kenneth
	Jesse Kriss (Superpowers), Affaan Mustafa (ECC), Garry Tan (gstack), Dex Horthy (HumanLayer), Kieran Klaassen (Compound Eng), Tabish Gilani (OpenSpec), Brian McAdams (BMAD), Lex Christopherson (GSD), Matt Pocock (Skills), Dani Avila (CC Templates), Dan Shipper (Every), Andrej Karpathy (AutoResearch), Peter Steinberger (OpenClaw), Sigrid Jin (claw-code), Yeachan Heo (oh-my-claudecode)
	Anthropic
	Lenny's Podcast, Y Combinator, The Pragmatic Engineer, Ryan Peterman, Every, MLOps Community

☠️ STARTUPS / BUSINESSES

Claude	Replaced
Code Review	Greptile, CodeRabbit, Devin Review, OpenDiff, Cursor BugBot
Voice Dictation	Wispr Flow, SuperWhisper

<a id="billion-dollar-questions"></a> Billion-Dollar Questions

If you have answers, do let me know at shanraisshan@gmail.com

Memory & Instructions (4)

What exactly should you put inside your CLAUDE.md — and what should you leave out?
If you already have a CLAUDE.md, is a separate constitution.md or rules.md actually needed?
How often should you update your CLAUDE.md, and how do you know when it's become stale?
Why does Claude still ignore CLAUDE.md instructions — even when they say MUST in all caps? (reddit)

Agents, Skills & Workflows (6)

When should you use a command vs an agent vs a skill — and when is vanilla Claude Code just better?
How often should you update your agents, commands, and workflows as models improve?
Should you have a generalist subagent or a feature-specific/role-specific agent? Does giving your subagent a detailed persona improve quality, and what does a "perfect persona prompt" for research/vision look like?
Should you rely on Claude Code's built-in plan mode — or build your own planning command/agent that enforces your team's workflow?
If you have a personal skill (e.g., /implement with your coding style), how do you incorporate community skills (e.g., /simplify) without conflicts — and who wins when they disagree?
Are we there yet? Can we convert an existing codebase into specs, delete the code, and have AI regenerate the exact same code from those specs alone?

Specs & Documentation (3)

Should every feature in your repo have a spec as a markdown file?
How often do you need to update specs so they don't become obsolete when a new feature is implemented?
When implementing a new feature, how do you handle the ripple effect on specs for other features?

🤔 Does code matter?

REPORTS

<img src="!/tags/how-to-use-hd.svg" alt="How to Use">

Get the maximum out of this repo by following these steps:

Read this repo as a course, not as a workflow or skill. It's reference material first; you'll run things later.
Don't use Claude as a chatbot. Learn the primitives — agents, commands, skills, hooks — and assemble them into your own workflow.
Run /weather-orchestrator to see a complete command → agent → skill flow. Use it as a template for any dev workflow, from planning to shipping.
Listen for the custom hook sounds while you work. Their implementation lives in the dedicated Claude Code Hooks repo; other patterns like Agent Teams ship inside this repo's implementation/ directory.
Learn the advanced topics and their implementations from the 🔥 Hot sub-table — for example, the Ralph Wiggum self-evolving loop is a full working repo you can clone to see one of these patterns end-to-end.
Point Claude at the tips and tricks section in your own project and ask it to suggest edits — especially how to restructure your CLAUDE.md. Every tip is sourced from the Claude team or the community.
Subscribe to the Reddit and YouTube channels in the Subscribe section to keep up with the community.

🎬 Videos

📊 Presentations

<a href="https://github.com/trending?since=monthly"><img src="!/root/github-trending.png" alt="GitHub Trending" width="1200"></a> ✨Trending on Github in March 2026✨

Star History

Other Repos

<table> <tr> <td align="center" width="140"> <a href="https://github.com/shanraisshan/claude-code-hooks"><img src="!/claude-speaking.svg" alt="Claude Code Hooks" width="64" height="64"></a> <a href="https://github.com/shanraisshan/claude-code-hooks">Claude Code Hooks</a> </td> <td align="center" width="140"> <a href="https://github.com/shanraisshan/codex-cli-best-practice"><img src="!/codex-jumping.svg" alt="Codex CLI Best Practice" width="64" height="64"></a> <a href="https://github.com/shanraisshan/codex-cli-best-practice">Codex CLI Best Practice</a> </td> <td align="center" width="140"> <a href="https://github.com/shanraisshan/codex-cli-hooks"><img src="!/codex-speaking.svg" alt="Codex CLI Hooks" width="64" height="64"></a> <a href="https://github.com/shanraisshan/codex-cli-hooks">Codex CLI Hooks</a> </td> <td align="center" width="140"> <a href="https://github.com/shanraisshan/gemini-cli-best-practice"><img src="!/gemini-jumping.svg" alt="Gemini CLI Best Practice" width="64" height="64"></a> <a href="https://github.com/shanraisshan/gemini-cli-best-practice">Gemini CLI Best Practice</a> </td> <td align="center" width="140"> <a href="https://github.com/shanraisshan/gemini-cli-hooks"><img src="!/gemini-speaking.svg" alt="Gemini CLI Hooks" width="64" height="64"></a> <a href="https://github.com/shanraisshan/gemini-cli-hooks">Gemini CLI Hooks</a> </td> </tr> </table>

Developed by

| # | Workflow | Description | |---|----------|-------------| | 1 | /workflows:development-workflows | Update the DEVELOPMENT WORKFLOWS table and cross-workflow analysis report by researching all 10 workflow repos in parallel | | 2 | /workflows:skill-collections | Update the SKILL COLLECTIONS table by researching all 5 skill-collection repos in parallel | | 3 | /workflows:agent-collections | Update the AGENT COLLECTIONS table by researching all agent-collection repos in parallel | | 4 | /workflows:best-practice:workflow-concepts | Update the README CONCEPTS section with the latest Claude Code features and concepts | | 5 | /workflows:best-practice:workflow-claude-settings | Track Claude Code settings report changes and find what needs updating | | 6 | /workflows:best-practice:workflow-claude-subagents | Track Claude Code subagents report changes and find what needs updating | | 7 | /workflows:best-practice:workflow-claude-commands | Track Claude Code commands report changes and find what needs updating | | 8 | /workflows:best-practice:workflow-claude-skills | Track Claude Code skills report changes and find what needs updating |

Extras

If you like my work, buy me a doodh patti 🍵 on

<a href="https://buy.polar.sh/polar_cl_R6wjUESl8RiJD0iVaTyStBUV6WNuYvDmLJ0si1XXj4C"><img src="!/tags/polar.svg" alt="Polar" width="40" height="40" align="center"></a> <a href="https://buy.polar.sh/polar_cl_R6wjUESl8RiJD0iVaTyStBUV6WNuYvDmLJ0si1XXj4C">Polar</a>

Want your brand in the header? Header placements are available — email shanraisshan@gmail.com.

安装

选择适合你当前 Agent 的方式

01 · 发给当前 Agent自动识别兼容方式与安装位置

请帮我安装「claude-code-best-practice」。它是一个 Agent Skill 或仓库级 Skill 包。
来源：https://github.com/shanraisshan/claude-code-best-practice

请先阅读仓库的 README、SKILL.md 与安装说明，再按我当前使用的 Agent 的原生规范安装；如果仓库兼容 Agent Skills CLI，优先执行「npx skills add https://github.com/shanraisshan/claude-code-best-practice」。不要写死为某一个 Agent 的专用目录，不覆盖已有同名文件。完成后告诉我实际安装位置、启用方式和验证结果。

在 GitHub 查看原文

本站按仓库级 package 收录，安装时克隆完整 claude-code-best-practice 仓库；已核验的 skill 入口为 .claude/skills/agent-browser/SKILL.md。

运行前阅读 README、依赖说明和 MIT 许可；涉及账号、外部写入或高风险领域时保留人工确认。

安装即视为你已阅读并遵守该 skill 的开源协议。内容版权归原作者所有。

claude-code-best-practice

主要能力

使用方式

适用边界

许可与来源

claude-code-best-practice

🧠 CONCEPTS

🔥 Hot

<a href="orchestration-workflow/orchestration-workflow.md"><img src="!/tags/orchestration-workflow-hd.svg" alt="Orchestration Workflow"></a>

⚙️ DEVELOPMENT WORKFLOWS

Others

🔀 CROSS-MODEL WORKFLOWS

🧰 SKILL COLLECTIONS

🤖 AGENT COLLECTIONS

💡 TIPS AND TRICKS (83)

Tips from Claude code CLI binary

🎬 VIDEOS / PODCASTS

🔔 SUBSCRIBE

☠️ STARTUPS / BUSINESSES

🤔 Does code matter?

REPORTS

<img src="!/tags/how-to-use-hd.svg" alt="How to Use">

Star History

Other Repos

Developed by

Extras

<img src="!/tags/sponsor-heart.svg" width="22" height="22" align="center"> Sponsor My Work