Skip to content
Back to search

claude-code-tresor

A world-class collection of Claude Code utilities: autonomous skills, expert agents, slash commands, and prompts that supercharge your development workflow

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/alirezarezvani-claude-code-tresor/badge.svg)](/listings/alirezarezvani-claude-code-tresor)

HTML

<a href="/listings/alirezarezvani-claude-code-tresor"><img src="/api/listings/alirezarezvani-claude-code-tresor/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.

Option 1: Automated Installation (Recommended)

# Clone the repository
git clone https://github.com/alirezarezvani/claude-code-tresor.git
cd claude-code-tresor

# Run the installation script (installs skills + agents + commands)
chmod +x scripts/install.sh
./scripts/install.sh

**What's installed:** - ✅ **8 Skills** - Automatic background helpers - ✅ **8 Agents** - Manual expert sub-agents - ✅ **4 Commands** - Workflow automation

**First time?** See [GETTING-STARTED.md](GETTING-STARTED.md) for 5-minute quick start.

Option 2: Manual Installation

# Copy skills to Claude Code directory
cp -r skills/* ~/.claude/skills/

# Copy commands to Claude Code directory
cp -r commands/* ~/.claude/commands/

# Copy agents to Claude Code directory
cp -r agents/* ~/.claude/agents/

# Copy resources for reference
cp -r prompts standards examples ~/claude-code-resources/

Option 3: Selective Installation

# Install only autonomous skills (v2.0+)
./scripts/install.sh --skills-only

# Install only slash commands
./scripts/install.sh --commands-only

# Install only agents
./scripts/install.sh --agents-only

# Install only resources (prompts, standards, examples)
./scripts/install.sh --resources-only

---

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 · 701 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 Tresor 🏆
  2. > A world-class collection of Claude Code utilities: autonomous skills, expert agents, slash commands, and prompts that supercharge your development workflow.
  3. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  4. [![Version](https://img.shields.io/badge/version-2.7.0-blue.svg)](https://github.com/alirezarezvani/claude-code-tresor)
  5. [![Quality](https://img.shields.io/badge/quality-9.7%2F10-brightgreen.svg)](docs/VALIDATION-REPORT-CONTENT.md)
  6. [![Claude Code](https://img.shields.io/badge/Claude%20Code-Compatible-blue.svg)](https://claude.ai/code)
  7. [![Contributions Welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg)](CONTRIBUTING.md)
  8. ## Also available on Smithery:
  9. [![Run in Smithery](https://smithery.ai/badge/skills/alirezarezvani)](https://smithery.ai/skills?ns=alirezarezvani&utm_source=github&utm_medium=badge)
  10. **Author**: Alireza Rezvani
  11. **Created**: September 16, 2025
  12. **Updated**: December 17, 2025 (v2.7.0 - Tresor Workflow Framework)
  13. **Quality**: 9.7/10 (Exceptional)
  14. **License**: MIT
  15. **Repository**: https://github.com/alirezarezvani/claude-code-tresor
  16. ---
  17. ## 🎉 What's New in v2.7.0
  18. **Major Release** - 10 New Orchestration Commands + Tresor Workflow Framework!
  19. - 🚀 **10 Orchestration Commands** - Production-grade intelligent orchestration (12,682 lines of code)
  20. - 🔒 **Security**: `/audit`, `/vulnerability-scan`, `/compliance-check`
  21. - ⚡ **Performance**: `/profile`, `/benchmark`
  22. - 🔧 **Operations**: `/deploy-validate`, `/health-check`, `/incident-response`
  23. - 📊 **Quality**: `/code-health`, `/debt-analysis`
  24. - 🤖 **Intelligent Agent Selection** - Auto-selects from 141 agents based on tech stack
  25. - 🔄 **Multi-Phase Orchestration** - 3-4 phases with parallel & sequential execution
  26. - 🛡️ **Dependency Verification** - Ensures safe parallel agent execution
  27. - 🔄 **Tresor Workflow Framework** - Meta-prompting, todo management, context handoff
  28. - 📦 **Consolidated Structure** - Unified agent directory in `/subagents/` (133 total agents)
  29. ---
  30. ### Previous: v2.6.0 - Quality Excellence
  31. **Quality Excellence Release** - Achieved 9.7/10 exceptional quality rating!
  32. - 🎨 **Design Category Transformation** - Improved from 4.0 to 8.0/10 (+100% quality boost)
  33. - 📚 **12 Enhanced Examples** - Added comprehensive usage examples to key agents
  34. - 📋 **Improved Consistency** - Standard sections added to 9 specialized agents
  35. - ✅ **Best Practices** - Added to config-safety-reviewer and security-auditor
  36. - 🤝 **Collaboration Guide** - Cross-team workflow documentation created
  37. - 📖 **Streamlined Docs** - Consolidated 21 files into 3 guides + archive
  38. **Backward Compatible** - No breaking changes from v2.5.0
  39. ### Previous Release: v2.5.0 (November 15, 2025)
  40. **Agent Reorganization & Extension** - 141 agents organized by team and function!
  41. - 🏗️ **New Structure** - `subagents/` directory with 10 color-coded team categories
  42. - 📦 **141 Total Agents** - 8 core + 133 subagents across all development domains
  43. - 🔄 **Core Agent Renaming** - systems-architect, config-safety-reviewer, root-cause-analyzer
  44. - 🎨 **Color Coding System** - Visual team identification (10 team colors)
  45. - 📚 **Comprehensive Documentation** - 450KB of guides, catalogs, and references
  46. **BREAKING CHANGES** (v2.5.0 only):
  47. - `@architect` → `@systems-architect`
  48. - `@code-reviewer` → `@config-safety-reviewer`
  49. - `@debugger` → `@root-cause-analyzer`
  50. ---
  51. ## 🎯 What is Claude Code Tresor?
  52. Claude Code Tresor is the ultimate collection of **professional-grade utilities** for Claude Code users. Whether you're a solo developer or part of a team, this repository provides battle-tested tools that integrate seamlessly into your development workflow.
  53. ### 🌟 Why Choose Claude Code Tresor?
  54. - **🚀 Production-Ready**: All utilities are tested and used in real-world projects
  55. - **📚 Comprehensive**: Covers the entire development lifecycle
  56. - **🛠️ Easy Installation**: One-command setup with automated updates
  57. - **🎨 Customizable**: Adapt templates to your specific needs and tech stack
  58. - **👥 Team-Friendly**: Includes collaboration guidelines and standards
  59. - **📖 Well-Documented**: Every component includes detailed examples and usage guides
  60. > **💡 Ecosystem Tip:** Looking for more? Check out the [Claude Code Skill Factory](https://github.com/alirezarezvani/claude-code-skill-factory) to build custom skills, or browse the [Claude Skills Library](https://github.com/alirezarezvani/claude-skills) for pre-built professional domain packages. See [Related Projects](#-related-projects--ecosystem) for details.
  61. >
  62. > **📖 [Complete Augmentation Guide](https://gist.github.com/alirezarezvani/a0f6e0a984d4a4adc4842bbe124c5935)** - Comprehensive guide with FAQs, use cases, and installation instructions
  63. >
  64. > ## 📚 Deep Dive
  65. ### Want to understand the architecture behind this 141-agent setup?
  66. - [141 Claude Code Agents: The Setup That Actually Works](https://medium.com/@alirezarezvani/141-claude-code-agents-the-setup-that-actually-works-a-complete-guide-98c2c79bf867?sk=73d5be97f9bd81a18edbcc0394e44b95)
  67. ---
  68. ## ✨ What's Included
  69. ### 🚀 Slash Commands (19 Total)
  70. **Development Commands** (4):
  71. | Command | Purpose | Example Usage |
  72. |---------|---------|---------------|
  73. | **`/scaffold`** | Generate project structures, components, and boilerplate | `/scaffold react-component UserProfile --hooks --tests` |
  74. | **`/review`** | Automated code review with security and performance analysis | `/review --scope staged --checks security,performance` |
  75. | **`/test-gen`** | Create comprehensive test suites automatically | `/test-gen --file utils.js --coverage 90` |
  76. | **`/docs-gen`** | Generate documentation from code and comments | `/docs-gen api --format openapi` |
  77. **Tresor Workflow Commands** (5):
  78. | Command | Purpose | Example Usage |
  79. |---------|---------|---------------|
  80. | **`/prompt-create`** | Generate optimized prompts for complex tasks | `/prompt-create Build user authentication system` |
  81. | **`/prompt-run`** | Execute generated prompts in sub-agents | `/prompt-run 001 --parallel` |
  82. | **`/todo-add`** | Capture ideas mid-conversation | `/todo-add Fix performance issue in API` |
  83. | **`/todo-check`** | Review and work on captured todos | `/todo-check` |
  84. | **`/handoff-create`** | Generate context handoff document | `/handoff-create` |
  85. **Orchestration Commands** (10) - **NEW in v2.7.0!**
  86. <details>
  87. <summary><b>🔒 Security Commands (3)</b></summary>
  88. | Command | Purpose | Duration | Key Features |
  89. |---------|---------|----------|--------------|
  90. | **`/audit`** | Comprehensive security audit | 2-4 hours | OWASP Top 10, pentesting, infrastructure review, RCA |
  91. | **`/vulnerability-scan`** | CVE & dependency scanning | 30-60 min | NVD correlation, SAST, exploit detection, auto-fix |
  92. | **`/compliance-check`** | Regulatory compliance validation | 1-2 hours | GDPR, SOC2, HIPAA, PCI-DSS, ISO 27001, CCPA |
  93. </details>
  94. <details>
  95. <summary><b>⚡ Performance Commands (2)</b></summary>
  96. | Command | Purpose | Duration | Key Features |
  97. |---------|---------|----------|--------------|
  98. | **`/profile`** | Performance profiling | 15min-2h | Bottleneck analysis, Core Web Vitals, query optimization |
  99. | **`/benchmark`** | Load testing | 5-30 min | Scenario generation, stress testing, capacity planning |
  100. </details>
  101. <details>
  102. <summary><b>🔧 Operations Commands (3)</b></summary>
  103. | Command | Purpose | Duration | Key Features |
  104. |---------|---------|----------|--------------|
  105. | **`/deploy-validate`** | Pre-deployment validation | 10-20 min | Test suite, config safety, go/no-go decision |
  106. | **`/health-check`** | System health verification | 5-15 min | Multi-layer checks, anomaly detection, alerting |
  107. | **`/incident-response`** | Production incident coordination | 30min-2h | Emergency triage, RCA, blameless postmortem |
  108. </details>
  109. <details>
  110. <summary><b>📊 Quality Commands (2)</b></summary>
  111. | Command | Purpose | Duration | Key Features |
  112. |---------|---------|----------|--------------|
  113. | **`/code-health`** | Codebase quality assessment | 20-40 min | Quality metrics, test coverage, maintainability scoring |
  114. | **`/debt-analysis`** | Technical debt identification | 30-60 min | Debt quantification, ROI prioritization, refactoring roadmap |
  115. </details>
  116. ### 🤖 Core Agents (8 Production-Ready)
  117. Expert-level assistance for complex development tasks:
  118. | Agent | Expertise | Best For |
  119. |-------|-----------|----------|
  120. | **`@config-safety-reviewer`** | Configuration safety, production reliability | Pool sizes, timeouts, connection limits, magic numbers |
  121. | **`@test-engineer`** | Testing strategies, test creation, QA | Unit tests, integration tests, coverage analysis |
  122. | **`@docs-writer`** | Technical documentation, user guides | API docs, README files, troubleshooting guides |
  123. | **`@systems-architect`** | System design, technology evaluation | Architecture reviews, design decisions, scalability |
  124. | **`@root-cause-analyzer`** | Comprehensive RCA, systematic debugging | Production incidents, complex bugs, performance issues |
  125. | **`@security-auditor`** | Security assessment, OWASP compliance | Security audits, vulnerability analysis, compliance |
  126. | **`@performance-tuner`** | Performance optimization, profiling | Performance issues, bottleneck analysis, optimization |
  127. | **`@refactor-expert`** | Code refactoring, clean architecture | Technical debt, code modernization, SOLID principles |
  128. ### 🌍 Extended Subagents (133 Specialists)
  129. **Total: 141 agents** (8 core + 133 subagents) organized in `subagents/` directory
  130. Organized by team and function across 10 color-coded categories:
  131. - **🔵 Engineering** (54) - Backend, frontend, mobile, DevOps, security, testing, 16 languages
  132. - **🏆 Leadership** (14) - Finance, strategy, risk, compliance
  133. - **🌱 Marketing** (11) - Content, social media, growth, SEO
  134. - **💜 Product** (9) - Product management, requirements, research, analytics
  135. - **🧠 AI/Automation** (9) - AI/ML engineering, automation, prompt engineering
  136. - **💙 Account/CS** (8) - Account management, customer success, sales, support
  137. - **🎨 Design** (7) - UI/UX design, visual design, branding (9.7/10 quality ⭐)
  138. - **🔶 Research** (7) - Market research, competitive intelligence, data research
  139. - **🌊 Operations** (6) - Analytics, infrastructure, support
  140. **Quality**: 9.7/10 (Exceptional - validated across all agents)
  141. **See:** [Complete Agent Catalog](subagents/README.md) | [Agent Index](subagents/AGENT-INDEX.md) | [Technical Reference](docs/TECHNICAL-REFERENCE.md)
  142. ### ✨ Skills (8 Autonomous) - **NEW!**
  143. Automatic background helpers that work while you code:
  144. | Skill | What It Does | Triggers On |
  145. |-------|--------------|-------------|
  146. | **`code-reviewer`** | Real-time code quality checks | File edits, saves |
  147. | **`test-generator`** | Suggests missing tests automatically | New functions, untested code |
  148. | **`git-commit-helper`** | Generates commit messages from diff | `git diff --staged` |
  149. | **`security-auditor`** | Detects vulnerabilities (SQL injection, XSS) | Auth code, API endpoints |
  150. | **`secret-scanner`** | Blocks commits with exposed secrets | Pre-commit, API keys in code |
  151. | **`dependency-auditor`** | Checks dependencies for CVEs | package.json changes |
  152. | **`api-documenter`** | Auto-generates OpenAPI specs | API routes added |
  153. | **`readme-updater`** | Keeps README current | Project changes, features |
  154. **Skills vs Agents:** Skills work **automatically** in the background. Agents require **manual invocation** (`@agent`) for deep analysis.
  155. **Learn more:** [Skills Guide](skills/README.md) · [Getting Started](GETTING-STARTED.md) · [Architecture](ARCHITECTURE.md)
  156. ### 📝 Curated Prompt Templates (20+)
  157. Ready-to-use prompts for common development scenarios:
  158. - **Frontend Development**: React, Vue, Angular, JavaScript/TypeScript
  159. - **Backend Development**: APIs, databases, authentication, microservices
  160. - **Debugging & Analysis**: Error analysis, performance troubleshooting
  161. - **Best Practices**: Clean code, security, refactoring strategies
  162. ### 📏 Development Standards
  163. Professional coding standards and style guides:
  164. - **JavaScript/TypeScript** style guide with ESLint/Prettier configs
  165. - **Git workflows** with conventional commits
  166. - **Code review** checklists and PR templates
  167. - **Team collaboration** guidelines
  168. ### 💡 Real-World Examples
  169. Complete workflow demonstrations:
  170. - **React App Setup**: Full modern React application from scratch
  171. - **API Development**: RESTful APIs with testing and documentation
  172. - **Performance Optimization**: Systematic performance improvement
  173. - **CI/CD Pipelines**: Automated testing and deployment
  174. ### 🏆 Quality Achievements
  175. **v2.6.0 Quality Metrics**:
  176. - **Overall Quality**: 9.7/10 (Exceptional - up from 7.1/10 in v2.5.0)
  177. - **YAML Validation**: 100% (all 141 agents valid)
  178. - **Content Quality**: 9.7/10 (comprehensive examples and best practices)
  179. - **Organization**: 100% (perfect categorization and structure)
  180. - **Cross-References**: 100% (all integrations validated)
  181. **Validation**: All agents tested across 4 validation tiers - YAML, Content, Organization, Cross-References
  182. ---
  183. ## 🔗 Related Projects & Ecosystem
  184. Looking to extend your Claude Code capabilities further? Check out these companion repositories:
  185. ### 🏭 [Claude Code Skill Factory](https://github.com/alirezarezvani/claude-code-skill-factory)
  186. **Build your own custom Skills and Agents at scale**
  187. A comprehensive toolkit for generating production-ready Claude Skills and Agents without starting from scratch. Perfect when you need specialized capabilities beyond what's available in pre-built collections.
  188. **Key Features:**
  189. - **Skills Factory**: Generate multi-file skill packages with Python code, documentation, and examples
  190. - **Agents Factory**: Create single-file specialist agents with enhanced YAML configuration
  191. - **Smart Architecture**: Automatically determines when functional code is needed vs. prompt-only approaches
  192. - **7 Reference Examples**: Financial analysis, AWS architecture, content research, Microsoft 365, and more
  193. - **Enterprise Standards**: Type-annotated code, error handling, and composable design
  194. **Best For:** Developers who need custom domain-specific capabilities, teams building proprietary workflows, or organizations requiring specialized AI tools tailored to their tech stack.
  195. **Use Case:** "I need a skill that analyzes our company's specific Terraform patterns" → Use Skill Factory to generate it
  196. ### 📚 [Claude Skills Library](https://github.com/alirezarezvani/claude-skills)
  197. **Production-ready skill packages for professional domains**
  198. A curated collection of specialized skill packages combining best practices, analysis tools, and strategic frameworks for various professional roles. Deploy expert-level capabilities immediately.
  199. **Available Collections:**
  200. - **Marketing** (3 packages): Content strategy, demand generation, product marketing
  201. - **C-Level Advisory** (2 packages): CEO and CTO strategic guidance
  202. - **Product Team** (6 packages): Product management, UX research, design systems, agile delivery
  203. - **Project Management** (6 packages): Jira, Confluence, Scrum, PMO, Atlassian integration
  204. - **Engineering** (9 packages): Architecture, fullstack, QA, DevOps, security, code review
  205. - **AI/ML/Data** (Coming soon): Data science and machine learning workflows
  206. **Key Benefits:**
  207. - **40%+ time savings** through domain-specific guidance
  208. - **30%+ quality improvements** with built-in best practices
  209. - **Python CLI utilities** for automated analysis and reporting
  210. - **Ready-to-use templates** for immediate deployment
  211. **Best For:** Teams needing enterprise-grade expertise packages, professionals seeking domain-specific guidance, or organizations standardizing workflows across multiple roles.
  212. **Use Case:** "I need comprehensive product management workflows with templates and frameworks" → Use Claude Skills Library
  213. ---
  214. ### 📖 Complete Ecosystem Guide
  215. **New to Claude Code augmentation?** Read the comprehensive guide with FAQs, installation instructions, and detailed use cases:
  216. **[📖 Complete Augmentation Guide](https://gist.github.com/alirezarezvani/a0f6e0a984d4a4adc4842bbe124c5935)** (GitHub Gist)
  217. This guide answers:
  218. - What is Claude Code augmentation and why should I use it?
  219. - How do Skills, Agents, Commands, and Hooks work?
  220. - Which repository should I use for my needs?
  221. - Step-by-step installation for all three repositories
  222. - 20+ FAQs covering installation, usage, and troubleshooting
  223. - 5+ detailed use cases with code examples
  224. ---
  225. ### 🎯 How These Projects Work Together
  226. | Your Need | Use This Repository |
  227. |-----------|-------------------|
  228. | **Ready-to-use utilities** (scaffolding, code review, testing, docs) | **Claude Code Tresor** (this repo) |
  229. | **Build custom skills** for your specific domain/tech stack | [**Skill Factory**](https://github.com/alirezarezvani/claude-code-skill-factory) |
  230. | **Deploy pre-built expertise** for professional roles | [**Skills Library**](https://github.com/alirezarezvani/claude-skills) |
  231. **Complete Workflow Example:**
  232. 1. **Start here** (Claude Code Tresor) → Install 8 skills + 8 agents + 4 commands for development workflows
  233. 2. **Browse Skills Library** → Add marketing, product, or engineering domain expertise packages
  234. 3. **Build custom with Skill Factory** → Generate proprietary skills for your company's unique needs
  235. All three repositories are **MIT licensed** and maintained by Alireza Rezvani.
  236. ---
  237. ## 📚 Documentation
  238. **[Complete Documentation →](documentation/README.md)**
  239. ### Quick Links
  240. - **[Installation Guide →](documentation/guides/installation.md)** - Install in 5 minutes
  241. - **[Getting Started →](documentation/guides/getting-started.md)** - Your first workflow
  242. - **[FAQ →](documentation/reference/faq.md)** - Common questions answered
  243. - **[Troubleshooting →](documentation/guides/troubleshooting.md)** - Fix issues
  244. ### Full Documentation
  245. - **[User Guides →](documentation/guides/)** - Installation, configuration, troubleshooting, migration, contributing
  246. - **[Technical Reference →](documentation/reference/)** - Complete skills, agents, and commands documentation
  247. - **[Workflows →](documentation/workflows/)** - Git workflow, GitHub automation, agent-skill integration
  248. ---
  249. ## 🚀 Quick Start
  250. ### Option 1: Automated Installation (Recommended)
  251. ```bash
  252. # Clone the repository
  253. git clone https://github.com/alirezarezvani/claude-code-tresor.git
  254. cd claude-code-tresor
  255. # Run the installation script (installs skills + agents + commands)
  256. chmod +x scripts/install.sh
  257. ./scripts/install.sh
  258. ```
  259. **What's installed:**
  260. - ✅ **8 Skills** - Automatic background helpers
  261. - ✅ **8 Agents** - Manual expert sub-agents
  262. - ✅ **4 Commands** - Workflow automation
  263. **First time?** See [GETTING-STARTED.md](GETTING-STARTED.md) for 5-minute quick start.
  264. ### Option 2: Manual Installation
  265. ```bash
  266. # Copy skills to Claude Code directory
  267. cp -r skills/* ~/.claude/skills/
  268. # Copy commands to Claude Code directory
  269. cp -r commands/* ~/.claude/commands/
  270. # Copy agents to Claude Code directory
  271. cp -r agents/* ~/.claude/agents/
  272. # Copy resources for reference
  273. cp -r prompts standards examples ~/claude-code-resources/
  274. ```
  275. ### Option 3: Selective Installation
  276. ```bash
  277. # Install only autonomous skills (v2.0+)
  278. ./scripts/install.sh --skills-only
  279. # Install only slash commands
  280. ./scripts/install.sh --commands-only
  281. # Install only agents
  282. ./scripts/install.sh --agents-only
  283. # Install only resources (prompts, standards, examples)
  284. ./scripts/install.sh --resources-only
  285. ```
  286. ---
  287. ## 🛠️ Usage Examples
  288. ### 🏗️ Project Setup
  289. ```bash
  290. # Create a complete React application
  291. /scaffold react-app my-project --typescript --tailwind --tests
  292. # Generate API endpoints with tests
  293. /scaffold express-api user-service --auth --database --tests
  294. ```
  295. ### 🔍 Code Review
  296. ```bash
  297. # Configuration safety review
  298. @config-safety-reviewer Review database connection pool settings for:
  299. - Pool size limits
  300. - Timeout configurations
  301. - Connection limit safety
  302. - Magic numbers
  303. # Security audit
  304. @security-auditor Please review this component for:
  305. - OWASP Top 10 vulnerabilities
  306. - Authentication/authorization
  307. - Input validation
  308. # Automated PR review
  309. /review --scope pr --checks security,performance,configuration
  310. ```
  311. ### 🧪 Testing
  312. ```bash
  313. # Generate comprehensive tests
  314. @test-engineer Create unit tests for this utility function with:
  315. - Edge case coverage
  316. - Error handling tests
  317. - Performance benchmarks
  318. # Automated test generation
  319. /test-gen --file components/UserCard.tsx --framework jest
  320. ```
  321. ### 📖 Documentation
  322. ```bash
  323. # Generate API documentation
  324. /docs-gen api --format openapi --include-examples
  325. # Create user guides
  326. @docs-writer Create a user guide for this authentication system with:
  327. - Setup instructions
  328. - Usage examples
  329. - Troubleshooting guide
  330. ```
  331. ---
  332. ## 📁 Repository Structure
  333. ```
  334. claude-code-tresor/
  335. ├── 📖 README.md # This file - complete overview
  336. ├── ⚖️ LICENSE # MIT License
  337. ├── 🤝 CONTRIBUTING.md # Contribution guidelines
  338. ├── 📚 GETTING-STARTED.md # 5-minute quick start guide
  339. ├── 🏗️ ARCHITECTURE.md # 3-tier system explanation
  340. ├── 🔄 MIGRATION-GUIDE.md # Upgrade guide for existing users
  341. ├──
  342. ├── ✨ skills/ # 8 Autonomous Skills (NEW v2.0!)
  343. │ ├── development/ # code-reviewer, test-generator, git-commit-helper
  344. │ ├── security/ # security-auditor, secret-scanner, dependency-auditor
  345. │ ├── documentation/ # api-documenter, readme-updater
  346. │ ├── README.md # Skills guide
  347. │ └── TEMPLATES.md # Custom skill templates
  348. ├──
  349. ├── 🤖 agents/ # 8 Specialized Agents
  350. │ ├── code-reviewer/ # Code quality expert
  351. │ ├── test-engineer/ # Testing specialist
  352. │ ├── docs-writer/ # Documentation expert
  353. │ ├── architect/ # System design expert
  354. │ ├── debugger/ # Debugging specialist
  355. │ ├── security-auditor/ # Security expert
  356. │ ├── performance-tuner/ # Performance optimization
  357. │ └── refactor-expert/ # Code refactoring
  358. ├──
  359. ├── ⚡ commands/ # 4 Slash Commands
  360. │ ├── development/ # Project scaffolding and tools
  361. │ ├── testing/ # Test generation and analysis
  362. │ ├── documentation/ # Doc generation utilities
  363. │ └── workflow/ # PR reviews and automation
  364. ├──
  365. ├── 📝 prompts/ # Prompt Templates
  366. │ ├── code-generation/ # Frontend & backend prompts
  367. │ ├── debugging/ # Error analysis prompts
  368. │ ├── architecture/ # System design prompts
  369. │ └── best-practices/ # Code quality prompts
  370. ├──
  371. ├── 📏 standards/ # Development Standards
  372. │ ├── style-guides/ # Language-specific guides
  373. │ ├── git-workflows/ # Git best practices
  374. │ └── templates/ # PR and issue templates
  375. ├──
  376. ├── 💡 examples/ # Real-World Examples
  377. │ ├── workflows/ # Complete project workflows
  378. │ ├── integrations/ # Service integration examples
  379. │ └── case-studies/ # Detailed project case studies
  380. ├──
  381. ├── 📦 sources/ # Extended Source Library
  382. │ ├── agents/ # 200+ additional agents
  383. │ └── slash-commands/ # Advanced command utilities
  384. ├──
  385. └── 🔧 scripts/ # Utility Scripts
  386. ├── install.sh # Easy installation
  387. └── update.sh # Update utilities
  388. ```
  389. ---
  390. ## 🎯 Getting Started Paths
  391. ### 👶 New to Claude Code?
  392. 1. **Install**: Run `./scripts/install.sh` (installs skills + agents + commands)
  393. 2. **Observe**: Skills work automatically - start coding and watch them detect issues
  394. 3. **Try Command**: `/scaffold react-component TestComponent --tests`
  395. 4. **Invoke Agent**: `@config-safety-reviewer` for configuration safety, `@security-auditor` for security analysis
  396. 5. **Learn**: Browse [GETTING-STARTED.md](GETTING-STARTED.md) for 5-min quick start
  397. ### 🏃‍♂️ Ready to Build?
  398. 1. **Skills monitor**: Automatic background checks (code quality, security, tests)
  399. 2. **Agent analysis**: `@config-safety-reviewer`, `@security-auditor`, `@test-engineer` for deep dives
  400. 3. **Command workflows**: `/review --scope staged`, `/test-gen --file utils.js`
  401. 4. **Full workflow**: Skills detect → Agents analyze → Commands orchestrate
  402. ### 👥 Team Lead?
  403. 1. **Standards**: Implement `standards/style-guides/javascript.md`
  404. 2. **Workflows**: Set up `standards/git-workflows/conventional-commits.md`
  405. 3. **Templates**: Use `standards/templates/` for consistency
  406. 4. **Training**: Share `examples/` with your team
  407. ### 🔧 Power User?
  408. 1. **Customize**: Adapt templates in `prompts/` for your needs
  409. 2. **Extend**: Explore additional utilities in `sources/`
  410. 3. **Build Custom**: Use [Skill Factory](https://github.com/alirezarezvani/claude-code-skill-factory) to generate proprietary skills
  411. 4. **Add Expertise**: Browse [Skills Library](https://github.com/alirezarezvani/claude-skills) for domain packages (marketing, product, engineering)
  412. 5. **Contribute**: Add your own utilities following `CONTRIBUTING.md`
  413. 6. **Automate**: Build custom workflows using the utilities
  414. ---
  415. ## 🚀 Updates & Maintenance
  416. ### Automatic Updates
  417. ```bash
  418. # Update all utilities
  419. ./scripts/update.sh
  420. # Check for updates without applying
  421. ./scripts/update.sh --check
  422. # Update specific components
  423. ./scripts/update.sh --commands-only
  424. ```
  425. ### Stay Current
  426. - ⭐ **Star this repository** to get notified of updates
  427. - 👀 **Watch releases** for new features and utilities
  428. - 📢 **Join discussions** to suggest improvements
  429. - 🤝 **Contribute** your own utilities and improvements
  430. ---
  431. ## 🤝 Contributing
  432. We welcome contributions from the community! Here's how to get involved:
  433. ### Quick Contributions
  434. - 🐛 **Report bugs** in GitHub Issues
  435. - 💡 **Suggest features** in GitHub Discussions
  436. - 📖 **Improve documentation** with clarifications
  437. - ⭐ **Share your experience** with others
  438. ### Code Contributions
  439. - 🔧 **Add new utilities** following our standards
  440. - 🎨 **Improve existing code** with enhancements
  441. - 🧪 **Add test coverage** for utilities
  442. - 📚 **Create examples** for complex workflows
  443. ### Process
  444. 1. **Fork** the repository
  445. 2. **Create** a feature branch: `git checkout -b feature/amazing-utility`
  446. 3. **Follow** our standards in `standards/` directory
  447. 4. **Test** your changes thoroughly
  448. 5. **Submit** a pull request using our template
  449. See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.
  450. ---
  451. ## 📊 Project Stats
  452. **This Repository:**
  453. - **✨ Skills**: 8 autonomous background helpers (v2.0+)
  454. - **🤖 Agents**: 133 total (8 core + 125 specialized) organized by team (v2.5+)
  455. - **⚡ Commands**: 19 total (4 dev + 5 workflow + 10 orchestration) (v2.7+)
  456. - **Development**: scaffold, review, test-gen, docs-gen
  457. - **Workflow**: prompt-create, prompt-run, todo-add, todo-check, handoff-create
  458. - **Orchestration**: audit, vulnerability-scan, compliance-check, profile, benchmark, deploy-validate, health-check, incident-response, code-health, debt-analysis
  459. - **📝 Prompt Templates**: 20+ battle-tested prompts
  460. - **📏 Standards**: 5 comprehensive style guides
  461. - **💡 Examples**: 10+ real-world workflows
  462. - **📦 Source Library**: 200+ additional components
  463. - **⏱️ Installation Time**: < 2 minutes
  464. - **📈 Version**: 2.7.0 (Major update: Orchestration Commands!)
  465. **Complete Ecosystem:**
  466. - **🏭 [Skill Factory](https://github.com/alirezarezvani/claude-code-skill-factory)**: Generate unlimited custom skills and agents
  467. - **📚 [Skills Library](https://github.com/alirezarezvani/claude-skills)**: 26+ pre-built professional domain packages (Marketing, Product, Engineering, PM, C-Level)
  468. - **🔄 Active Development**: All three repositories continuously updated
  469. - **⚖️ License**: MIT across all projects
  470. ---
  471. ## 🏆 Success Stories
  472. ### Individual Developers
  473. > *"Claude Code Tresor cut my React setup time from hours to minutes. The testing utilities alone saved me weeks of work!"* - Sarah K., Frontend Developer
  474. ### Development Teams
  475. > *"Our code quality improved dramatically after implementing the standards and review workflows. PRs are now focused on logic, not style."* - Mike R., Tech Lead
  476. ### Agencies & Consultancies
  477. > *"We use Claude Code Tresor as our standard toolkit. It ensures consistency across all client projects and speeds up delivery."* - Jennifer L., CTO
  478. ---
  479. ## 📄 License & Usage
  480. This project is licensed under the **MIT License** - see [LICENSE](LICENSE) for details.
  481. ### You Can:
  482. - ✅ Use for commercial and personal projects
  483. - ✅ Modify and distribute
  484. - ✅ Create derivative works
  485. - ✅ Include in proprietary software
  486. ### Requirements:
  487. - 📄 Include copyright notice and license
  488. - 🏷️ Credit original author when sharing
  489. ---
  490. ## 🙏 Acknowledgments
  491. - **Claude Code Team**: For creating an amazing development platform
  492. - **Open Source Community**: For inspiration and best practices
  493. - **Contributors**: Everyone who has helped improve these utilities
  494. - **Users**: For feedback and real-world testing
  495. Special thanks to developers worldwide who believe in sharing knowledge and tools to make development better for everyone.
  496. ---
  497. ## 📞 Support & Community
  498. ### Get Help
  499. - 📋 **Issues**: [GitHub Issues](https://github.com/alirezarezvani/claude-code-tresor/issues) for bugs and feature requests
  500. - 💬 **Discussions**: [GitHub Discussions](https://github.com/alirezarezvani/claude-code-tresor/discussions) for questions and ideas
  501. - 📖 **Documentation**: Browse `examples/` directory for detailed guides
  502. - 🔍 **Search**: Use repository search to find specific utilities
  503. ### Connect
  504. - 🐦 **Twitter**: [@alirezarezvani](https://twitter.com/alirezarezvani)
  505. - 💼 **LinkedIn**: [Alireza Rezvani](https://linkedin.com/in/alirezarezvani)
  506. - 🌐 **Website**: [https://alirezarezvani.com] (Portfolio Website)
  507. - 🌐 **Claude Code Tutorials and Guides**: [https://medium.com/@alirezarezvani] (Medium Blog)
  508. ### Professional Support
  509. For professional support, custom utilities, or team training:
  510. - 📧 **Email**: [Your professional email]
  511. - 💼 **Consulting**: Available for custom development and team training
  512. ---
  513. ## ⭐ Star History
  514. If you find Claude Code Tresor valuable, please consider starring the repository! It helps others discover these utilities and motivates continued development.
  515. [![Star History Chart](https://api.star-history.com/svg?repos=alirezarezvani/claude-code-tresor&type=Date)](https://star-history.com/#alirezarezvani/claude-code-tresor&Date)
  516. ---
  517. <div align="center">
  518. **Made with ❤️ by [Alireza Rezvani](https://github.com/alirezarezvani)**
  519. *Empowering developers with world-class Claude Code utilities*
  520. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  521. [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
  522. [![Code Quality](https://img.shields.io/badge/Code%20Quality-A+-brightgreen.svg)](standards/)
  523. **🚀 [Get Started Now](#-quick-start) | 📚 [View Examples](examples/) | 🤝 [Contribute](CONTRIBUTING.md)**
  524. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

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