Claude Code Best Practice: a course with demo setups
shanraisshan/claude-code-best-practice
A free course on setting up Claude Code well, written as notes, tips and reports. It also holds a working demo setup: a weather example that shows how a command, a helper and a skill hand work to each other. The skills in it are teaching examples (Dubai weather, Pakistan time), not tools for your own work.
Pack description by its author: “A free course on setting up Claude Code well, written as notes, tips and reports. It also holds a working demo setup: a weather example that shows how a command, a helper and a skill hand work to each other. The skills in it are teaching examples (Dubai weather, Pakistan time), not tools for your own work.”
Software engineeringKnowledge and rules for your assistantCommands you run when needed
1. Changes your files
Skills that write or edit files: weather-orchestrator (command) with weather-fetcher and weather-svg-creator, rpi (/rpi:research, /rpi:plan, /rpi:implement), presentation-structure, presentation-styling, vibe-to-agentic-framework, time-fetcher, time-svg-creator (agent-teams/).
github.com/shanraisshan/claude-code-best-practice/blob/9d31b3e/2. Runs code on your machine
Almost every Claude Code event (30 events: each tool use, prompt, session start and end, subagents ...): python3 runs hooks.py, which plays a short sound with afplay (macOS), paplay/aplay/ffplay/mpg123 (Linux) or winsound (Windows). No network. A git commit gets its own sound. Same hooks, if logging is turned on: Appends each event's data to .claude/hooks/logs/hooks-log.jsonl inside the project. Logging is off in the shipped config.
github.com/shanraisshan/claude-code-best-practice/blob/9d31b3e/3. Sends data
No malware signs and no hidden instructions found. The risk is the sample settings: opened as a trusted project, Claude Code may run any shell command without asking and starts three npx tool servers, and Codex runs without a sandbox or approvals. Read .claude/settings.json, .mcp.json and .codex/config.toml before you trust the folder, and do not copy them into your own projects as they are.
github.com/shanraisshan/claude-code-best-practice/blob/9d31b3e/4. Commercial use
MIT: keep the license notice
github.com/shanraisshan/claude-code-best-practice/blob/9d31b3e/Checked against the pack's files at commit 9d31b3e, on Oct 29, 2026. Tap a verdict to see its source.How we checkedReport an error
The pack has changed since AgentGid checked it on Oct 29, 2026. Some details may be out of date.
Good for you if
- You use Claude Code and want to learn its building blocks before you build your own setup
- You want a worked example of a command that hands work to a helper and then to a skill
- You want a step-by-step research, plan and build routine with go / no-go checks to copy into your project
Probably not for you if
- You want ready skills that do real work for you: the skills here fetch Dubai weather or show Pakistan time
- You open projects in Claude Code or Codex without reading their settings first: this folder's settings are very permissive
What its answer looks like
The weather demo's saved result
# Weather Result ## Temperature 89.3°F ## Location Dubai, UAE ## Unit Fahrenheit ## SVG Card 
The skill's own example, from orchestration-workflow/output.md. More examples
What you'll notice
- Opened in Claude Code, the folder plays a short sound on almost every step (needs python3)
- /weather-orchestrator asks Celsius or Fahrenheit, fetches Dubai's temperature and writes a small picture card
- Three extra tool servers are downloaded and started if you accept the folder's settings
- Its project notes tell the assistant to treat this repo as the main source for Claude Code questions
What you need
- Claude Code, Codex
- Free, MIT license
- No package: read it on GitHub, or open a copy of the folder in Claude Code; the research, plan and build routine is copied by hand
- agent-browser needs a separate agent-browser tool that this repo does not ship.
Words on this page
- Skill
- A set of written instructions your AI assistant follows. Installing one is like giving it a playbook.
- Slash command
- A command you type in the assistant's chat, starting with /.
- Hook
- A small program the assistant runs by itself at set moments, for example when a session starts.
- Subagent
- A helper the assistant starts for one part of a task.
- MCP
- A standard way to connect an AI assistant to outside tools and data.
- Plugin
- A package your assistant installs that can bring skills, commands and hooks together.
- Repository
- A project folder on GitHub with its files and history.
- CLI
- A program you run by typing commands in a terminal.
| Repository | shanraisshan/claude-code-best-practice · website |
|---|---|
| GitHub stars | 69,301 |
| Skills | 9 |
| Category | Software engineering |
| License | MIT |
| Last updated | Nov 22, 2026 · card checked Oct 29, 2026 at commit 9d31b3e |
| Install counts | shanraisshan/claude-code-best-practice on skills.sh, Vercel's skills directory, which shows installs and security audits per skill |
shanraisshan/claude-code-best-practice popularity over time
What Claude Code Best Practice does
- Guides and reports in best-practice/, reports/, tips/, videos/ and implementation/: how subagents, commands, skills, hooks, memory, settings and tool servers work
- A demo of command → helper → skill: /weather-orchestrator asks for a unit, a weather helper fetches Dubai's temperature, a skill writes an SVG card
- A copyable research → plan → implement routine (development-workflows/rpi) with a go / no-go step and a folder of plan files per feature
- A sample .claude folder with sound hooks for 30 events, permissions, project tool servers and an agent-teams demo
- Many links to other people's skill and agent collections; those are not checked by this card
From the pack's SKILL.md files, summarised by AgentGid.
The 2 skills, explained
weather-orchestrator (command) with weather-fetcher and weather-svg-creator
Teaching demo: gets Dubai's temperature and draws it as a small picture card
You give
- Celsius or Fahrenheit, asked in a question
You get
- Current Dubai temperature and unit
- orchestration-workflow/weather.svg, a picture card
- orchestration-workflow/output.md, a short summary
rpi (/rpi:research, /rpi:plan, /rpi:implement)
A three-step routine: check if a feature is worth it, plan it, then build it in phases
You give
- A short feature request saved as rpi/<feature>/REQUEST.md
- Your go-ahead at each step
You get
- research/RESEARCH.md with a GO or NO-GO verdict
- plan/PLAN.md plus product, design and technical notes
- implement/IMPLEMENT.md, a record of the phased build
See it in action
The skill defines what its answer looks like. Its own example:
# Weather Result ## Temperature 89.3°F ## Location Dubai, UAE ## Unit Fahrenheit ## SVG Card 
When to reach for it
| You want | Use |
|---|---|
| To see how a command, a helper and a skill pass work along | /weather-orchestrator |
| A go / no-go check before building a feature | /rpi:research rpi/<feature>/REQUEST.md |
| A phased plan, then a phased build | /rpi:plan <feature>, then /rpi:implement <feature> |
| To learn one Claude Code feature | Read the matching file in best-practice/ or implementation/ |
Skills in shanraisshan/claude-code-best-practice
| Skill | In plain words | Changes files? | What it does (author) |
|---|---|---|---|
| agent-browser | Lets the assistant drive a web browser through a separate tool you install yourself | No | 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…npx skills add shanraisshan/claude-code-best-practice --skill agent-browser |
| presentation-structure | — | — | Knowledge about the presentation slide format, weight system, navigation, and section structurenpx skills add shanraisshan/claude-code-best-practice --skill presentation-structure |
| presentation-styling | — | — | Knowledge about CSS classes, component patterns, and syntax highlighting in the presentationnpx skills add shanraisshan/claude-code-best-practice --skill presentation-styling |
| vibe-to-agentic-framework | — | — | The conceptual framework behind the presentation — what "Vibe Coding to Agentic Engineering" means, why the journey is structured the way it is, and how every slide fits the narrative arcnpx skills add shanraisshan/claude-code-best-practice --skill vibe-to-agentic-framework |
time-skill/time-skill |
Teaching demo: shows the current time in Pakistan | No | Display the current time in Pakistan Standard Time (PKT, UTC+5). Use when the user asks for the current time, Pakistan time, or PKT.npx skills add shanraisshan/claude-code-best-practice --skill time-skill |
| weather-fetcher | — | — | Instructions for fetching current weather temperature data for Dubai, UAE from Open-Meteo APInpx skills add shanraisshan/claude-code-best-practice --skill weather-fetcher |
| weather-svg-creator | — | — | Creates an SVG weather card showing the current temperature for Dubai. Writes the SVG to orchestration-workflow/weather.svg and updates orchestration-workflow/output.md.npx skills add shanraisshan/claude-code-best-practice --skill weather-svg-creator |
| time-fetcher | — | — | Instructions for fetching current Dubai time via bash commandnpx skills add shanraisshan/claude-code-best-practice --skill time-fetcher |
| time-svg-creator | — | — | Creates an SVG time card showing the current time for Dubai. Writes the SVG to agent-teams/output/dubai-time.svg and updates agent-teams/output/output.md.npx skills add shanraisshan/claude-code-best-practice --skill time-svg-creator |
The author's descriptions come from each skill's SKILL.md; the plain-words column is AgentGid's.
Good to know before you install
- It is a course, not a skill pack. The author says to read it first; the skills are demos about Dubai weather and Pakistan time.
- The folder's Claude Code settings pre-approve every shell command, every file edit and web fetches to any site. If you accept them, the assistant stops asking before it runs commands in this folder.
- The Codex settings turn off the sandbox and all approval prompts for Codex in this folder.
- The settings switch on all project tool servers: Playwright, Context7 and DeepWiki, each downloaded from npm with npx -y when the session starts.
- The project notes tell the assistant to answer Claude Code questions from this repo before other sources, and to make one commit per file.
- The settings also replace the spinner words and tips with the author's own lines and set a custom status line.
Before you start
Works in
- Claude Code: project .claude folder (open the repo, or copy the rpi commands)
- Codex: project .codex folder (config and hooks)
You will need
- Python 3: The sound hooks run python3 on Claude Code events
- Node.js (npx): The three project tool servers start with npx
- agent-browser CLI: Needed only for the agent-browser skill; not shipped here
Steps only you can do
- Decide whether to trust the folder's project settings and its three project tool servers when Claude Code asks (.claude/settings.json and .mcp.json in the repo)
Then: The agent can run the demos; if the person declines, it reads the guides only - Decide whether to open the folder in Codex at all, given that its config turns off the sandbox and approvals (.codex/config.toml in the repo)
Then: The agent works in Codex only after the person removes or accepts that config
Mistakes to avoid
Install it as a skill pack and expect the skills to do your work
Read it as a course; the skills are demos (Dubai weather, Pakistan time) to copy the pattern from
The author says the repo is reference material, not a workflow or skillCopy the sample .claude/settings.json into your own project as it is
Copy only the parts you need and write your own permissions list
The sample pre-approves every shell command, every edit and web fetches to any domainOpen the folder in Codex expecting the usual sandbox and approval prompts
Read .codex/config.toml first, or remove it from your copy before opening the folder in Codex
The project config turns off the sandbox and all approvalsRun /rpi:implement with --skip-validation to go faster
Keep the validation gate between phases
The flag skips the check that each phase is done before the next one startsAsk for the agent-browser skill without the agent-browser tool installed
Install the separate agent-browser CLI first, or skip this skill
The skill only calls the agent-browser command, which this repo does not ship
Which one to pick
| If you need | Pick |
|---|---|
| You want a course on Claude Code with a worked command → helper → skill demo and a research, plan and build routine | This pack |
| You want a short list of practical Claude Code tips with a status line script | ykdojo/claude-code-tips |
| You want a long single guide to Claude Code with quizzes | FlorianBruniaux/claude-code-ultimate-guide |
| You want a ready skills workflow that does real work in your project | obra/superpowers |
Works well with
- claude-code: The course, its sample .claude folder and the demos are built for Claude Code
- openai-codex: The repo also ships a .codex folder with sample hooks
- open-meteo: The weather demo reads Dubai's temperature from Open-Meteo
- context7: One of the three project tool servers in .mcp.json
May I use it like this?
| Use | Answer | Condition |
|---|---|---|
| In a commercial app | Yes | MIT: keep the license notice |
| Passing the files on | Yes | MIT: keep the copyright and permission notice in copies |
| Work for clients | Yes | MIT allows use in work for others |
What leaves your machine
- A weather request for Dubai's fixed coordinates and the chosen unit (no personal data) → api.open-meteo.com, Each run of /weather-orchestrator. Opt out: Do not run the weather demo
- Library and repository questions the assistant sends to the Context7 and DeepWiki tool servers → The Context7 and DeepWiki services over the internet, When the assistant calls those tool servers in a session opened in this folder. Opt out: Decline the project tool servers, or remove them from .mcp.json and turn off enableAllProjectMcpServers
Install Claude Code Best Practice
Official commands from the repository
claude /weather-orchestrator
Run inside a copy of this repo. Read .claude/settings.json and .mcp.json before accepting them; see know.
Remove: delete the folder
Copy development-workflows/rpi/.claude (agents/ and commands/rpi/) to your project root, then create rpi/plans.
Remove: delete the copied agents, commands/rpi and the rpi folder
Codex reads .codex/config.toml and .codex/hooks.json in this folder; they turn off the sandbox and approvals.
Or with the open-source skills CLI: npx skills add shanraisshan/claude-code-best-practice. Skills are instructions your agent follows: read them before installing.
What it installs and runs on your machine
Read in the code at commit 9d31b3e, Oct 29, 2026
| When | What happens |
|---|---|
| Almost every Claude Code event (30 events: each tool use, prompt, session start and end, subagents ...) | python3 runs hooks.py, which plays a short sound with afplay (macOS), paplay/aplay/ffplay/mpg123 (Linux) or winsound (Windows). No network. A git commit gets its own sound. |
| Same hooks, if logging is turned on | Appends each event's data to .claude/hooks/logs/hooks-log.jsonl inside the project. Logging is off in the shipped config. |
| Codex sessions in this folder | 8 Codex hooks run .codex/hooks/scripts/hooks.py for sounds; at session start it adds the line "hooks context: run" to the chat. |
| Session start with the settings accepted | npx -y downloads and starts three tool servers from npm: @playwright/mcp, @upstash/context7-mcp, deepwiki-mcp. Context7 and DeepWiki answer over the internet. |
| /weather-orchestrator | The assistant fetches api.open-meteo.com for Dubai's temperature and writes two files in orchestration-workflow/. |
| time-skill | The assistant runs the date command with the Asia/Karachi time zone. |
| RPI routine | Text only; the assistant writes plan files under rpi/<feature>/ and then changes your code phase by phase. |
Settings
.claude/hooks/config/hooks-config.json: disable<Event>Hook switches per event and disableLogging (true by default).claude/hooks/config/hooks-config.local.json: Personal overrides, not committedCLAUDE_AUTOCOMPACT_PCT_OVERRIDE: Set to 80 in the shipped settings
Quick answers
- Is it free?
- Yes, MIT license.
- Is this a skill pack I install?
- No. The author calls it a course; there is no plugin or install command. The skills are teaching demos.
- Is it safe to open in Claude Code or Codex?
- Read the settings first. They pre-approve all shell commands, start three npx tool servers, and in Codex turn off the sandbox and approvals.
- Does anything send my data out?
- The sound hooks do not. The weather demo calls Open-Meteo, and the Context7 and DeepWiki tool servers work over the internet.
- How do I silence the sounds?
- Set disableAllHooks to true in .claude/settings.local.json, or turn off single hooks in hooks-config.json.
Checked by AgentGid on Oct 29, 2026 against commit 9d31b3e of the pack's own files. Related: shanraisshan/claude-code-hooks, anthropics/skills. agent.md for AI agents · Report a mistake
More software engineering skill packs
| # | Skill pack | Skills | GitHub stars | Updated |
|---|---|---|---|---|
| 1 |
mattpocock/skills Your AI coding assistant gets a set of working habits for building software. It interviews you about a plan before it builds, tur…
|
39 | 330K | 2026-11-19 |
| 2 |
obra/superpowers Your coding assistant follows one fixed way of working. Before it builds anything, it asks what you really want and writes a shor…
|
15 | 324K | 2026-11-03 |
| 3 |
multica-ai/andrej-karpathy-skills Your AI coding assistant gets four rules: think before coding, keep it simple, change only what you asked for, and set a clear go…
|
1 | 235K | 2026-04-20 |
| 4 |
DietrichGebert/ponytail Your AI coding assistant stops overbuilding. It does what you asked in the simplest way that works, reuses what your project alre…
|
6 | 197K | 2026-11-22 |
| 5 |
Shubhamsaboo/awesome-llm-apps This repo is mostly a big collection of AI apps and tutorials. Its agent_skills folder holds seven separate skills you install on…
|
10 | 145K | 2026-11-18 |
| 6 |
addyosmani/agent-skills Your AI coding assistant works like a careful senior engineer. It writes down what to build before coding, splits the work into s…
|
26 | 120K | 2026-11-18 |