Skip to content

Claude Code Infrastructure Showcase

Example reference library of Claude Code setup: skills that auto-activate via hooks, plus agents.

Stars
10k
Forks
1.2k
Licence
MIT
Language
TypeScript
Last update
4 months ago
Type
Learning resource

What it is

This is a reference library of configuration files, hook scripts, skill guides, and agents for Claude Code, Anthropic's coding assistant. It addresses the problem of skills (markdown guides Claude loads) not loading on their own, using hooks that run on each prompt and a config file that maps prompts and files to skills. The README says it is not a working application; you copy the pieces you need into your own project.

  • Copy the .claude/ folder into a Node.js or React project to get skills that suggest themselves based on prompt keywords
  • Adapt the skill-rules.json file to map your own project's file paths and prompts to guidelines
  • Use the bundled verification script to check that hooks, permissions, and configuration are set up correctly
  • Optionally enable AI-based skill classification with a provider key, falling back to regex matching

Great for

  • Developers already using Claude Code on a larger TypeScript or Node.js project
  • Teams who want a starting point for auto-activating project-specific guidelines
  • People who want examples of hooks, skill-rules.json, and specialized agents to adapt
  • Users comfortable with a terminal and bash scripts on macOS, Linux, or WSL2

Not ideal for

  • Windows users outside WSL2, because the README says the hooks are bash scripts that won't run in plain cmd or PowerShell
  • Anyone wanting a ready-made app to run directly, since the README states it is not a working application
  • Beginners new to Claude Code who have not yet read the concepts section, since the setup assumes familiarity with hooks and config files
Step-by-step guide: how to use Claude Code Infrastructure ShowcaseInstall, first run, examples, tips and FAQs

How to get it

  1. 1

    Clone and build from source

    You'll need: Node.js 18+ (20+ recommended) and npm · macOS, Linux, or WSL2 · jq (only if enabling the optional Stop hooks)

    Clone the repo

    git clone https://github.com/diet103/claude-code-infrastructure-showcase.git

    Run the setup wizard on your project

    npx tsx setup.ts ~/my-project

    Verify the setup

    bash .claude/scripts/verify-setup.sh
  2. 2

    Run it

    • Clone the repository and run the setup wizard against your project folder
    • Answer the wizard prompts about mode (Classic regex-only or AI-Enhanced)
    • Run the verification script from your project root to confirm the eight checks pass
    • Type a prompt in Claude Code matching a skill keyword and check that the suggested skill appears
  3. 3

    Get the most out of it

    • Edit skill-rules.json to match your project's own file paths and prompt keywords
    • Keep customized skills and skill-rules.json under version control, since upgrades do not overwrite them
    • Use the skill-developer skill as a guide when writing new skills
    • Review the eight specialized agents in the .claude/agents folder for patterns you can reuse

Downloads

Strengths

  • Built from the author's stated six months of use on a TypeScript microservices project
  • Default mode is free and offline, with no API key required
  • Setup includes a verification script with fix commands for common failures

Trade-offs

  • The README describes it as a reference library rather than a finished tool, so you must adapt it to your own project
  • Examples are tied to specific stacks (React, Express, Prisma, MUI) and a generic blog domain, so they may not match yours
  • Optional AI mode depends on third-party providers and their keys or models, which may change

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.