Skip to content
Back to search

claude-setup

SkillWorks with Claude CodeGitHub

> A comprehensive configuration setup for Claude Code with Model Context Protocol (MCP) servers, custom commands, and quality-focused workflows.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/aizenvoltprime--claude-setup/badge.svg)](/listings/aizenvoltprime--claude-setup)

HTML

<a href="/listings/aizenvoltprime--claude-setup"><img src="/api/listings/aizenvoltprime--claude-setup/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# 1. Install dependencies
pip install uv

# 2. Clone this configuration
git clone <your-repo> claude-setup
cd claude-setup

# 3. Start using commands
/task implement user authentication

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 528 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Claude Code Setup
  2. > A comprehensive configuration setup for Claude Code with Model Context Protocol (MCP) servers, custom commands, and quality-focused workflows.
  3. [![Claude Code](https://img.shields.io/badge/Claude%20Code-Compatible-blue.svg)](https://claude.ai/code) [![MCP](https://img.shields.io/badge/MCP-Enabled-green.svg)](https://modelcontextprotocol.io/) [![Python](https://img.shields.io/badge/Python-3.8+-blue.svg)](https://python.org)
  4. ## Table of Contents
  5. - [Overview](#overview)
  6. - [Quick Start](#quick-start)
  7. - [Prerequisites](#prerequisites)
  8. - [Installation](#installation)
  9. - [Features](#features)
  10. - [Commands](#commands)
  11. - [Configuration](#configuration)
  12. - [Troubleshooting](#troubleshooting)
  13. - [Contributing](#contributing)
  14. - [License](#license)
  15. ## Overview
  16. This project provides a pre-configured environment for Claude Code with enhanced capabilities through:
  17. - **MCP Servers**: Context7 for library documentation and code context
  18. - **Custom Commands**: Intelligent workflows for commits, tasks, code review, and prompt optimization
  19. - **Code Quality Tools**: Modern CLI tool enforcement and validation hooks
  20. - **Structured Workflows**: Organized task management with best practices
  21. ## Quick Start
  22. ```bash
  23. # 1. Install dependencies
  24. pip install uv
  25. # 2. Clone this configuration
  26. git clone <your-repo> claude-setup
  27. cd claude-setup
  28. # 3. Start using commands
  29. /task implement user authentication
  30. ```
  31. ## Prerequisites
  32. Before using this setup, ensure you have:
  33. - **Claude Code**: Installed and configured
  34. - **Python 3.8+**: For hook script execution
  35. - **uv**: Package manager for Python script execution
  36. - **Node.js**: For MCP server functionality (npx)
  37. ### Installation
  38. #### 1. Install uv (if not already installed)
  39. ```bash
  40. # macOS/Linux
  41. curl -LsSf https://astral.sh/uv/install.sh | sh
  42. # Windows
  43. powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
  44. # After installation, open a new terminal and verify:
  45. uv --version
  46. ```
  47. #### 2. Setup Configuration
  48. ```bash
  49. # Copy configuration files to your project
  50. cp -r .claude/ /your/project/
  51. cp .mcp.json /your/project/
  52. ```
  53. ## Modern CLI Tools Installation Guide
  54. ### Linux Installation Commands
  55. #### Ubuntu/Debian (Complete Single Command)
  56. **Prerequisites - Install Rust (for xsv and sd):**
  57. ```bash
  58. curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  59. source "$HOME/.cargo/env"
  60. ```
  61. **Complete installation (core tools only):**
  62. ```bash
  63. sudo apt update && sudo apt install -y ripgrep bat fd-find && mkdir -p ~/.local/bin && ln -sf /usr/bin/batcat ~/.local/bin/bat && ln -sf /usr/bin/fdfind ~/.local/bin/fd && cargo install sd xsv
  64. ```
  65. **Complete installation (core + optional tools):**
  66. ```bash
  67. sudo apt update && sudo apt install -y ripgrep bat fd-find jq && mkdir -p ~/.local/bin && ln -sf /usr/bin/batcat ~/.local/bin/bat && ln -sf /usr/bin/fdfind ~/.local/bin/fd && cargo install sd xsv && sudo wget -qO /usr/local/bin/yq https://github.com/mikefarah/yq/releases/latest/download/yq_linux_amd64 && sudo chmod +x /usr/local/bin/yq
  68. ```
  69. **What this does:**
  70. - Updates package lists
  71. - Installs `ripgrep`, `bat`, `fd-find`, `jq` from apt
  72. - Creates `~/.local/bin` directory
  73. - Symlinks `batcat` → `bat` and `fdfind` → `fd` (fixes naming conflicts)
  74. - Installs `sd`, `xsv` via Cargo (Rust package manager)
  75. - Downloads and installs `yq` binary
  76. #### Arch Linux (Simplest Single Command)
  77. ```bash
  78. sudo pacman -S ripgrep bat fd sd jq yq
  79. ```
  80. **Optional AUR tools:**
  81. ```bash
  82. yay -S xsv mdq
  83. ```
  84. #### Fedora/RHEL/CentOS
  85. ```bash
  86. sudo dnf install -y ripgrep bat fd-find jq && cargo install sd xsv && sudo wget -qO /usr/local/bin/yq https://github.com/mikefarah/yq/releases/latest/download/yq_linux_amd64 && sudo chmod +x /usr/local/bin/yq
  87. ```
  88. #### Alpine Linux
  89. ```bash
  90. apk add ripgrep bat fd jq yq && cargo install sd xsv
  91. ```
  92. ### Windows Installation Commands
  93. #### Using winget (Recommended)
  94. **Core tools - Required (single command):**
  95. ```powershell
  96. winget install BurntSushi.ripgrep.MSVC && winget install sharkdp.bat && winget install sharkdp.fd && winget install chmln.sd && winget install BurntSushi.xsv.MSVC
  97. ```
  98. **Optional tools (for specialized operations):**
  99. ```powershell
  100. winget install jqlang.jq && winget install MikeFarah.yq
  101. ```
  102. **Individual installations:**
  103. ```powershell
  104. # Core tools (required)
  105. winget install BurntSushi.ripgrep.MSVC
  106. winget install sharkdp.bat
  107. winget install sharkdp.fd
  108. winget install chmln.sd
  109. winget install BurntSushi.xsv.MSVC
  110. # Optional tools
  111. winget install jqlang.jq
  112. winget install MikeFarah.yq
  113. ```
  114. #### Using Scoop
  115. ```powershell
  116. scoop install ripgrep bat fd sd jq yq
  117. ```
  118. #### Using Chocolatey
  119. ```powershell
  120. choco install ripgrep bat fd-find sd jq yq
  121. ```
  122. ### macOS Installation
  123. #### Using Homebrew
  124. ```bash
  125. brew install ripgrep bat fd sd jq yq xsv mdq
  126. ```
  127. ### Tool Mappings Reference
  128. | Legacy Tool | Modern Replacement | Package Name | Enforcement |
  129. | ----------- | ------------------ | ------------------ | ----------- |
  130. | `grep` | `rg` | ripgrep | **Blocked** |
  131. | `cat` | `bat` | bat | **Blocked** |
  132. | `find` | `fd` | fd / fd-find | **Blocked** |
  133. | `awk/perl` | `sd` | sd | **Blocked** |
  134. | `cut` | `xsv` | xsv (winget/cargo) | **Blocked** |
  135. | JSON ops | `jq` | jq | Suggested |
  136. | YAML ops | `yq` | yq | Suggested |
  137. | Markdown | `mdq` | mdq (cargo) | Suggested |
  138. **Blocked**: Hook prevents execution and requires modern tool
  139. **Suggested**: Hook provides recommendation but allows execution
  140. ### Verification Commands
  141. **Verify core tools (required):**
  142. ```bash
  143. rg --version
  144. bat --version
  145. fd --version
  146. sd --version
  147. xsv --version
  148. ```
  149. **Verify optional tools:**
  150. ```bash
  151. jq --version
  152. yq --version
  153. ```
  154. ### Notes
  155. **Ubuntu/Debian Naming Conflicts:**
  156. - `bat` is installed as `batcat` (conflict with `bacula-console-qt`)
  157. - `fd` is installed as `fdfind` (conflict with `fdclone`)
  158. - Symlinks in `~/.local/bin` resolve this issue
  159. **Cargo Requirement:**
  160. - **Windows**: All core tools available via winget - no Cargo needed!
  161. - **Linux**: Core tools `sd` and `xsv` require Rust's Cargo package manager
  162. - Optional tool `mdq` requires Cargo on all platforms
  163. - **Install Rust (Linux)**: `curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh`
  164. **PATH Configuration:**
  165. - Ensure `~/.local/bin` is in your PATH (usually automatic on modern Linux)
  166. - Add to `~/.bashrc` or `~/.zshrc` if needed: `export PATH="$HOME/.local/bin:$PATH"`
  167. ## Features
  168. ### 🎯 Custom Commands
  169. - **`/commit`**: Intelligent commit workflow with conventional standards
  170. - **`/code-review`**: Reviews uncommitted changes before committing
  171. - **`/task`**: Structured problem-solving with best practices and code quality guidelines
  172. - **`/optimize-prompt`**: Analyzes and optimizes prompts using the 10 golden rules for AI interaction
  173. ### 🤖 Custom Agents
  174. - **`code-reviewer`**: Senior code review specialist for quality assurance
  175. - Reviews changes for quality, security, and maintainability
  176. - Provides prioritized feedback (critical, warnings, suggestions)
  177. - Checks for best practices and potential issues
  178. ### 🔌 MCP Servers
  179. - **Context7**: Library documentation and code context
  180. ### ⚡ Hook System
  181. - **PreToolUse**: Tool validation for modern CLI tool enforcement
  182. - **Extensible**: Easy to add custom hooks for workflow automation
  183. - **Documentation**: [Hooks Reference](https://docs.anthropic.com/en/docs/claude-code/hooks) | [Hooks Guide](https://docs.anthropic.com/en/docs/claude-code/hooks-guide)
  184. ## Commands
  185. ### `/task` - Structured Problem Solving
  186. Structured workflow for problem-solving with built-in code quality guidelines.
  187. **Usage:**
  188. ```bash
  189. /task [problem description]
  190. ```
  191. **Features:**
  192. - ✅ Step-by-step analysis before implementation
  193. - ✅ Edge case identification and handling
  194. - ✅ Self-documenting code with clear naming conventions
  195. - ✅ XML documentation for public APIs
  196. - ✅ Root cause focus (no bandaid fixes)
  197. - ✅ No unnecessary fallbacks or backwards compatibility
  198. **Output Format:**
  199. 1. **Brief Analysis**: Key considerations and edge cases identified
  200. 2. **Solution**: Clean, production-ready code
  201. 3. **Summary**: One-line description of changes made
  202. **Examples:**
  203. ```bash
  204. /task implement user authentication system
  205. /task fix the null reference in payment processing
  206. /task add validation to the user registration form
  207. ```
  208. ### `/optimize-prompt` - Prompt Optimization
  209. Analyzes and transforms prompts using the 10 golden rules for maximizing AI output quality.
  210. **Usage:**
  211. ```bash
  212. /optimize-prompt [your prompt to analyze]
  213. ```
  214. **Features:**
  215. - ✅ Scorecard evaluation against 10 optimization rules
  216. - ✅ Detailed improvement recommendations
  217. - ✅ Fully rewritten optimized prompt
  218. - ✅ Automatic export to `.claude/optimized-prompts/`
  219. **The 10 Golden Rules:**
  220. 1. Tone of Collaboration - Clear, firm, respectful
  221. 2. Principle of Explicitness - Action + Quantity + Topic + Audience
  222. 3. Defining Boundaries - Constraints produce better results
  223. 4. Exploratory Draft - Plan → Refine → Execute
  224. 5. Output Details - Structured formats (tables, JSON, lists)
  225. 6. Explaining the "Why" - Context and intent
  226. 7. Art of Brevity - Specify detail level
  227. 8. Providing a Scaffold - Templates and examples
  228. 9. Power Phrases - "Think step-by-step", "Critique your response"
  229. 10. Divide & Conquer - Break massive tasks into sub-tasks
  230. ### `/code-review` - Automated Code Review
  231. Initiates code-reviewer agent to analyze uncommitted changes only.
  232. **Usage:**
  233. ```bash
  234. /code-review
  235. ```
  236. **Features:**
  237. - Focuses exclusively on uncommitted changes
  238. - Reviews modified files for quality, security, and maintainability
  239. - Provides prioritized feedback:
  240. - 🚨 Critical issues (must fix)
  241. - ⚠️ Warnings (should fix)
  242. - 💡 Suggestions (consider improving)
  243. - Includes specific fix examples
  244. **Example:**
  245. ```bash
  246. # After making changes
  247. /code-review
  248. # Fix any critical issues
  249. /commit
  250. ```
  251. ### `/commit` - Intelligent Commits
  252. Streamlined commit workflow following conventional commit standards.
  253. **Features:**
  254. - Diff analysis and change summarization
  255. - Conventional commit message formatting
  256. - Clean, focused commits
  257. **Important:** Run `/code-review` before committing to ensure code quality.
  258. **Example:**
  259. ```bash
  260. # Review changes first
  261. /code-review
  262. # After fixing issues
  263. /commit
  264. ```
  265. ## Configuration
  266. ### Directory Structure
  267. ```
  268. claude-setup/
  269. ├── .claude/
  270. │ ├── settings.json # Permissions and hook configuration
  271. │ ├── settings.local.json # Local MCP server settings
  272. │ ├── agents/
  273. │ │ └── code-reviewer.md # Code review specialist
  274. │ ├── hooks/
  275. │ │ └── tool_validation_hook.py # Modern CLI tool enforcement
  276. │ ├── commands/
  277. │ │ ├── task.md # Structured task workflow
  278. │ │ ├── optimize-prompt.md # Prompt optimization workflow
  279. │ │ ├── code-review.md # Code review workflow
  280. │ │ └── commit.md # Commit workflow
  281. │ └── optimized-prompts/ # Auto-generated optimized prompts
  282. ├── .mcp.json # MCP server configuration
  283. └── README.md
  284. ```
  285. ### Settings Configuration
  286. The `.claude/settings.json` file contains permissions and hook configurations:
  287. ```json
  288. {
  289. "permissions": {
  290. "allow": ["WebFetch(domain:docs.anthropic.com)", ...],
  291. "deny": [...]
  292. },
  293. "hooks": {
  294. "PreToolUse": [
  295. {
  296. "matcher": "Bash",
  297. "hooks": [
  298. {
  299. "type": "command",
  300. "command": "uv run .claude/hooks/tool_validation_hook.py"
  301. }
  302. ]
  303. }
  304. ]
  305. }
  306. }
  307. ```
  308. The `.claude/settings.local.json` file enables MCP servers:
  309. ```json
  310. {
  311. "enabledMcpjsonServers": ["context7"],
  312. "enableAllProjectMcpServers": true
  313. }
  314. ```
  315. ### MCP Configuration
  316. The `.mcp.json` file defines server configurations:
  317. ```json
  318. {
  319. "mcpServers": {
  320. "context7": {
  321. "command": "npx",
  322. "args": ["-y", "@upstash/context7-mcp"],
  323. "env": {
  324. "DEFAULT_MINIMUM_TOKENS": "6000"
  325. }
  326. }
  327. }
  328. }
  329. ```
  330. ## Troubleshooting
  331. ### Common Issues
  332. **Hook not triggering:**
  333. - Ensure `uv` is installed and in PATH
  334. - Check script permissions: `chmod +x .claude/hooks/*.py`
  335. - Verify hook configuration in `.claude/settings.json`
  336. **Modern CLI tools not found:**
  337. - Install the required tools using the installation commands in the [Modern CLI Tools Installation Guide](#modern-cli-tools-installation-guide)
  338. - Verify installation with version commands (e.g., `rg --version`, `bat --version`)
  339. - Ensure tools are in your PATH
  340. **MCP servers not loading:**
  341. - Verify Node.js and npx are installed
  342. - Check `.mcp.json` configuration syntax
  343. - Ensure MCP packages are available via npx
  344. - Verify `enabledMcpjsonServers` in `.claude/settings.local.json`
  345. ### Debug Mode
  346. Enable debug mode for detailed logging:
  347. ```bash
  348. claude --debug
  349. ```
  350. ## Contributing
  351. 1. Fork the repository
  352. 2. Create a feature branch: `git checkout -b feature-name`
  353. 3. Make your changes and test thoroughly
  354. 4. Submit a pull request with detailed description
  355. ### Adding Custom Commands
  356. 1. Create markdown file in `.claude/commands/`
  357. 2. Use `$ARGUMENTS` placeholder for user input
  358. 3. Define clear instructions and output format
  359. ### Adding Custom Hooks
  360. 1. Create script in `.claude/hooks/`
  361. 2. Make executable: `chmod +x .claude/hooks/your_hook.py`
  362. 3. Add configuration to `.claude/settings.json`
  363. 4. Test with sample inputs
  364. **Resources:**
  365. - [Hooks Reference Documentation](https://docs.anthropic.com/en/docs/claude-code/hooks)
  366. - [Hooks Implementation Guide](https://docs.anthropic.com/en/docs/claude-code/hooks-guide)
  367. ## Star History
  368. [![Star History Chart](https://api.star-history.com/svg?repos=AizenvoltPrime/claude-setup&type=Date)](https://star-history.com/#AizenvoltPrime/claude-setup&Date)
  369. ## License
  370. This configuration setup is provided as-is for Claude Code enhancement.
  371. ---
  372. **Need help?** Check the documentation:
  373. - [Claude Code Main Docs](https://docs.anthropic.com/claude-code)
  374. - [Hooks Reference](https://docs.anthropic.com/en/docs/claude-code/hooks)
  375. - [Hooks Implementation Guide](https://docs.anthropic.com/en/docs/claude-code/hooks-guide)
  376. Or open an issue for project-specific questions.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.