Skip to content
Agents tracked: 502 Releases (7d): 762 Agent status: no reported issuesSince last limit reset: Claude 11d · Codex 9d For AI agents: Markdown Updated Nov 22, 2026

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

GitHub

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.

Knowledge and rules for your assistantCommands you run when needed

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
![Weather Card](weather.svg)

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.
Repositoryshanraisshan/claude-code-best-practice · website
GitHub stars69,301
Skills9
CategorySoftware engineering
LicenseMIT
Last updatedNov 22, 2026 · card checked Oct 29, 2026 at commit 9d31b3e
Install countsshanraisshan/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

Most starred skill packs

shanraisshan/claude-code-best-practice: GitHub starstotal over time 69,301
shanraisshan/claude-code-best-practice: new stars per weekGitHub 250

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
Say: “/weather-orchestrator”

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
Say: “/rpi:research rpi/oauth2-authentication/REQUEST.md”

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
![Weather Card](weather.svg)

From orchestration-workflow/output.md.

When to reach for it

You wantUse
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 featureRead the matching file in best-practice/ or implementation/
Try it. Read best-practice/claude-skills.md on GitHub first. To see the demo, open a copy of the folder in Claude Code, check .claude/settings.json, then type /weather-orchestrator. It asks Celsius or Fahrenheit and writes orchestration-workflow/weather.svg; that file changing is how you know it ran.

Skills in shanraisshan/claude-code-best-practice

SkillIn plain wordsChanges files?What it does (author)
agent-browser Lets the assistant drive a web browser through a separate tool you install yourselfNo 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 structure
npx skills add shanraisshan/claude-code-best-practice --skill presentation-structure
presentation-styling —— Knowledge about CSS classes, component patterns, and syntax highlighting in the presentation
npx 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 arc
npx skills add shanraisshan/claude-code-best-practice --skill vibe-to-agentic-framework
time-skill
/time-skill
Teaching demo: shows the current time in PakistanNo 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 API
npx 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 command
npx 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

  1. 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
  2. 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 skill
  • Copy 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 domain
  • Open 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 approvals
  • Run /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 starts
  • Ask 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 needPick
You want a course on Claude Code with a worked command → helper → skill demo and a research, plan and build routineThis pack
You want a short list of practical Claude Code tips with a status line scriptykdojo/claude-code-tips
You want a long single guide to Claude Code with quizzesFlorianBruniaux/claude-code-ultimate-guide
You want a ready skills workflow that does real work in your projectobra/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?

UseAnswerCondition
In a commercial app YesMIT: keep the license notice
Passing the files on YesMIT: keep the copyright and permission notice in copies
Work for clients YesMIT 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

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

WhenWhat 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 onAppends 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 folder8 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 acceptednpx -y downloads and starts three tool servers from npm: @playwright/mcp, @upstash/context7-mcp, deepwiki-mcp. Context7 and DeepWiki answer over the internet.
/weather-orchestratorThe assistant fetches api.open-meteo.com for Dubai's temperature and writes two files in orchestration-workflow/.
time-skillThe assistant runs the date command with the Asia/Karachi time zone.
RPI routineText 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 committed
  • CLAUDE_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

All software engineering skills

# 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