convez.ai
SkillProdutividadeIntermediário
jchildree

Claud-itect-Skill

jchildree/Claud-itect-Skill

Pack completo de skills para Claude Code com instalação automatizada

Ver no GitHub
InicialPluginScore · de 0 a 100

Pack de 54 skills curadas, 4 definições de agents e hooks automáticos para Claude Code. Instala e configura tudo em um comando, incluindo integração com thefuck para correção automática de erros de terminal.

Instalação

$npx convez-ai jchildree/Claud-itect-Skill

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
4
Forks
0
Acompanhando
1
Saúde
28%
Último commit
há 4 meses
Versão
—
Issues abertas
1
Contribuidores
2

Casos de uso

  • Acelerar setup de projetos em Claude Code
  • Automatizar correções de erros no terminal
  • Utilizar agents e skills pré-configuradas sem configuração manual

Veredito

Skill pack prático que reduz significativamente o tempo de setup inicial em Claude Code. Bom para quem quer começar rápido sem configura manualmente 54 ferramentas, embora dependa de Node.js e sua utilidade real dependa do ecossistema específico do seu projeto.

README

A tradução para o português deste README ainda está na fila.

Claude-ITect-Skill

Are you a Claude Architect or as the industry refuses to call us: Claude-ITects™? Good. You're in the right place.

Welcome to Claude-ITect-Skill: The "I don't want to configure 54 things manually" starter pack for Claude Code. Powered by Captain Caveman energy -- one club, infinite tools, zero yak-shaving.

What you get (whether you deserve it or not):

  • 🧠 54 curated skills
  • 🤖 4 agent definitions
  • 🪓 Caveman session hooks (one command, no thinking required)
  • 🔧 thefuck integration for when your terminal betrays you.

But don't get distracted by the features.

The real sorcery happens during setup when everything just… works.

No funny dances. No ritual sacrifices.

Install it. Try it. Judge me harshly afterward.

After installation start with these skills:

  • /onboard <- run first
  • /audit <- run next

Prerequisites


Install

Windows

  1. Open PowerShell (search "PowerShell" in the Start menu).
  2. Navigate to your project:
    cd "C:\path\to\your\project"
    
  3. Run the installer -- replace the path with wherever you saved the skill pack:
    powershell -ExecutionPolicy Bypass -File "C:\path\to\Claude-ITect-Skill\install.ps1"
    
    To install into a specific project instead of the current directory:
    powershell -ExecutionPolicy Bypass -File "C:\path\to\Claude-ITect-Skill\install.ps1" -ProjectPath "C:\path\to\your\project"
    
FlagEffect
-ForceOverwrite skills that already exist
-SkipHooksSkip auto-wiring hooks into settings.json

Note: -ExecutionPolicy Bypass only applies to this one run -- it does not change your system settings.


macOS / Linux

  1. Open a terminal.
  2. Make the script executable (one-time step):
    chmod +x "/path/to/Claude-ITect-Skill/install.sh"
    
  3. Navigate to your project and run:
    cd /path/to/your/project
    bash "/path/to/Claude-ITect-Skill/install.sh"
    
    Or install into a specific path directly:
    bash "/path/to/Claude-ITect-Skill/install.sh" /path/to/your/project
    
FlagEffect
--forceOverwrite skills that already exist
--skip-hooksSkip auto-wiring hooks into settings.json

What gets installed

your-project/
  └── .claude/
      ├── skills/     54 skills
      ├── agents/     4 agent definitions
      └── hooks/      7 hook files

settings.json is patched to wire caveman hooks (SessionStart + UserPromptSubmit). Existing entries are preserved. NgonENGINE-specific commands in commands-ngon/ are not auto-installed. Comment if you want these as well.


After installing

Restart Claude Code. Then run /onboard to verify the installation. Duplicate skills are uploaded to trigger audit skill to ensure this pack of skills nests within your repository skills efficiently.


Skills (54)

Superpowers -- workflow orchestration

Auto-trigger at key moments to shape agent behavior before and during implementation.

SkillTriggers on
brainstormingAny feature/creative work -- fires before implementation
dispatching-parallel-agents2+ independent tasks with no shared state
executing-plansWritten plan ready to execute in a fresh session
finishing-a-development-branchImplementation complete, deciding how to integrate
receiving-code-reviewResponding to review feedback
requesting-code-reviewPre-merge verification, major feature complete
subagent-driven-developmentBreaking work across multiple agents
systematic-debuggingStructured bug hunting with hypothesis loop
tdd-enforceTDD Iron Law enforcement -- write test first, no exceptions
using-git-worktreesParallel work on multiple branches
using-superpowersBootstrap -- injects skill awareness at session start
verification-before-completionFinal check before declaring a task done
writing-plansCreating structured implementation plans
writing-skillsAuthoring new Claude Code skill files

Engineering

SkillPurpose
diagnoseDisciplined diagnosis loop: reproduce → minimise → hypothesise → fix → regression-test
grill-with-docsInterview codebase to build CONTEXT.md and ADR entries
improve-codebase-architectureArchitecture review and improvement proposals
prototypeSpike a solution before committing to full implementation
tdd-guideTDD philosophy, planning, and tracer-bullet concept
to-issuesBreak a plan/PRD into independently-grabbable GitHub issues
to-prdSynthesize conversation context into a PRD and publish
triageMove issues through the triage state machine
zoom-outStep back and evaluate whether the current approach is correct

Caveman -- token compression

Cuts token usage ~75% while keeping full technical accuracy.

SkillPurpose
cavemanCompressed communication. Levels: lite, full, ultra, wenyan-*
caveman-commitUltra-compressed commit message generator
caveman-compressCompress CLAUDE.md / memory files into caveman format
caveman-helpQuick-reference card for all caveman modes and commands
caveman-reviewUltra-compressed PR review comments
caveman-statsShow real token usage from session log
cavecrewDecision guide for delegating to cavecrew subagents

Utilities

SkillPurpose
adrCreate, review, audit, and list Architectural Decision Records
auditAudit skill files for visibility flags, determinism, and composability
git-guardrails-claude-codeEnforce pre-commit guardrails via Claude Code hooks
karpathyKarpathy-style code quality principles (internal reasoning layer)
llm-wikiSet up and operate an LLM-maintained personal knowledge base
memory-to-vaultConvert Claude's persisted memory into a structured Obsidian vault note
migrate-to-shoehornMigrate to shoehorn pattern
onboardInteractive first-run experience -- generates a personalized 5-skill starter roadmap
phasePhase-based project management with status lexicon
safe-pushPre-flight large-file, test, uncommitted-change, and diverged-history checks before git push
scaffold-exercisesScaffold coding exercise structures
setup-joseph-childree-skillsOne-time per-repo setup for issue tracker, triage labels, and domain docs
setup-pre-commitConfigure pre-commit hooks for a repo
thefuckFix the previous failed shell command
toolsDiscover and configure MCP servers and CLI tools
wikiRead, approve, add, search, and graph commands for the project Obsidian vault
wiki-suggestScan source files for undocumented content and generate wiki suggestion files

Productivity

SkillPurpose
grill-meRelentless interview -- stress-tests plans and designs
handoffCompact current conversation into a handoff doc for another agent

Writing

SkillPurpose
edit-articleEdit and improve written articles
writing-beatsStructure writing into beats
writing-fragmentsWork with writing fragments
writing-shapeShape and structure long-form writing

Personal / Misc

SkillPurpose
obsidian-vaultObsidian vault integration workflows

TheFuck

Diagnoses and corrects failed shell commands. Wraps the thefuck CLI if installed.

Triggers: failed command in session, "fix that", "fuck", "what should I have typed", "correct that"

Behavior: identifies error class (typo, missing sudo, wrong flag, bad path, etc.), proposes corrected command, confirms before running. Never executes destructive corrections silently.

Install the CLI (optional):

winget install thefuck          # Windows
brew install thefuck            # macOS
pip install thefuck             # any platform

Add shell alias:

# bash/zsh
eval $(thefuck --alias)
# PowerShell ($PROFILE)
$env:TF_SHELL = "powershell"; iex "$(thefuck --alias)"

Agents (4)

Installed to .claude/agents/. Spawn via Agent tool with subagent_type.

Agentsubagent_typePurpose
CaveCrew Buildercavecrew-builder1-2 file surgical edits only. Hard refuses 3+ file scope.
CaveCrew Investigatorcavecrew-investigatorRead-only code locator. Returns file:line table. No fix suggestions.
CaveCrew Reviewercavecrew-reviewerDiff reviewer. One finding per line, severity-tagged. No praise.
Geometry Solvergeometry-solverNgonENGINE math -- Newell normals, MVC, GJK/EPA, SubRegion, planarity.

Hooks (7)

Installed to .claude/hooks/. Require Node.js.

FileEventPurpose
caveman-activate.jsSessionStartInjects active caveman ruleset into session context
caveman-mode-tracker.jsUserPromptSubmitRe-injects caveman level reminder each turn
check-encoding.jsPostToolUse(Write|Edit)Blocks write if file contains em-dashes, en-dashes, smart quotes, or UTF-8 BOM
caveman-config.jssharedReads/writes caveman mode config
caveman-stats.json demandReads real token counts from session log
caveman-statusline.ps1statusLine[CAVEMAN] badge in Claude Code status bar (Windows)
captain-caveman.jsSessionStartPlays Captain Caveman entrance sound once on first session
package.jsonsharedHook dependencies

The install script writes SessionStart and UserPromptSubmit entries into .claude/settings.json using the absolute path of the installed hooks directory.

Status bar badge (optional, Windows):

{
  "statusLine": {
    "type": "command",
    "command": "powershell -ExecutionPolicy Bypass -File \".claude\\hooks\\caveman-statusline.ps1\""
  }
}
Claude-ITect-Skill v2.0/
├── skills/           54 skill directories
├── agents/           4 agent .md files
├── hooks/            8 hook files (JS + PS1)
├── commands-ngon/    4 NgonENGINE-specific slash commands (not auto-installed)
├── install.ps1       Windows installer
├── install.sh        Unix installer
├── CLAUDE.md         Reference (auto-loaded by Claude Code)
└── README.md         This file

Captain Caveman Entrance Sound (Optional)

Because legendary skill packs deserve legendary entrances.

What It Does

Plays the iconic Captain Caveman roar once on your first Claude Code session. Cross-platform. Zero extra dependencies. After that glorious first moment? Silent operation.

Quick Setup

  1. Get a sound file - any short WAV under 3 seconds:

    • Find "Captain Caveman sound effect" on YouTube
    • Download and convert: ffmpeg -i input.mp3 captain-caveman.wav
    • Or use any triumphant sound effect you like
  2. Add to repo before installing:

    Claude-ITect-Skill/
    └── assets/
        └── captain-caveman.wav  <- place your WAV here
    
  3. Run the installer - it auto-detects and wires the hook

  4. Start Claude Code - prepare for glory

Platform Support

PlatformWorks?Notes
macOSAlwaysUses afplay (ships with OS)
LinuxUsuallyNeeds aplay, paplay, mpg123, or ffplay
WindowsAlwaysUses PowerShell Media.SoundPlayer

Disable It

Remove from .claude/settings.json:

{
  "hooks": {
    "SessionStart": [
      ".claude/hooks/caveman-activate.js"
    ]
  }
}

Full Documentation

See CAPTAIN-CAVEMAN.md for:

  • Detailed setup instructions
  • Troubleshooting guide
  • How to reset for testing
  • Technical implementation details

Sources

If you're reading this far. Thanks. If I have made you laugh at any point, or in the future, please hit that star button, or if you're feeling super generous, Buy Me Coffee donations are always appreciated. If you have ideas to improve it, leave a comment in the Discussions.

SourceSkills
superpowersWorkflow orchestration (brainstorming, executing-plans, etc.)
mattpocock/skillsEngineering and productivity (diagnose, tdd, to-issues, etc.)
cavemanToken compression plugin (caveman, cavecrew, etc.)
thfuckthefuck fix it tool
karpathy skillkarpathy skill AI mental logic
MY REPOSLook around at my shiny new toys
Ver o original no GitHub

Bom para

Relacionados