claude-skill-lord 2.0.5 → 2.0.7

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-skill-lord",
-  "version": "2.0.5",
+  "version": "2.0.6",
   "description": "Curated Claude Code plugin — 43 agents, 170 skills, 114 commands, 11 language rules",
   "author": {
     "name": "Dong Anh",

package/CLAUDE.md

@@ -68,7 +68,7 @@ Curated best-of-both plugin merging ClaudeKit Engineer (base) + Everything Claud
 | go-build-resolver | Go |
 | pytorch-build-resolver | PyTorch |
 
-## Skills (170)
+## Skills (161)
 
 All skills live in `./skills/<name>/SKILL.md` — flat structure, no tiers.
 

package/README.md

@@ -5,7 +5,7 @@
 [![npm](https://img.shields.io/npm/v/claude-skill-lord)](https://www.npmjs.com/package/claude-skill-lord)
 ![License](https://img.shields.io/badge/license-MIT-green)
 ![Agents](https://img.shields.io/badge/agents-43-purple)
-![Skills](https://img.shields.io/badge/skills-170-orange)
+![Skills](https://img.shields.io/badge/skills-161-orange)
 ![Commands](https://img.shields.io/badge/commands-114-red)
 ![Rules](https://img.shields.io/badge/rules-11%20languages-blue)
 
@@ -13,7 +13,7 @@
 
 ## Why Claude Skill Lord?
 
-- **Stop configuring, start building** — 170 skills, 43 agents, 114 commands work out of the box
+- **Stop configuring, start building** — 161 skills, 43 agents, 114 commands work out of the box
 - **Multi-language support** — 11 language-specific rule sets (TypeScript, Python, Go, Rust, Java, Kotlin, C++, C#, PHP, Perl, Swift) + common rules
 - **Language-specific agents** — dedicated reviewers and build resolvers for 8 languages
 - **Design intelligence built-in** — 67 UI styles, 161 color palettes, reasoning engine for production-grade design decisions
@@ -43,7 +43,7 @@ That's it. `csl init` copies skills, agents, and commands into `.claude/` and ge
 
 ```bash
 csl init                # interactive setup (asks profile + target)
-csl init full           # install everything (170 skills + canvas fonts)
+csl init full           # install everything (161 skills + canvas fonts)
 csl init --dry-run      # preview without copying
 csl init --fresh        # clean reinstall
 csl upgrade full        # upgrade to full profile (additive, no overwrites)
@@ -80,7 +80,7 @@ graph TD
     subgraph Plugin["Claude Skill Lord Plugin"]
         A["Agents (43)"]
         B["Commands (114)"]
-        C["Skills (170)"]
+        C["Skills (161)"]
         R["Rules (11 langs)"]
     end
 
@@ -289,7 +289,7 @@ See [commands/](commands/) for the full list.
 
 ---
 
-## Skills (170)
+## Skills (161)
 
 All skills live in `./skills/<name>/SKILL.md` — flat structure.
 

package/agents/brainstormer.md

@@ -28,6 +28,8 @@ description: >-
       This requires researching best practices, considering UX/DX implications, and evaluating multiple technical approaches.
       </commentary>
     </example>
+model: sonnet
+tools: All tools
 ---
 
 You are a Solution Brainstormer, an elite software engineering expert who specializes in system architecture design and technical decision-making. Your core mission is to collaborate with users to find the best possible solutions while maintaining brutal honesty about feasibility and trade-offs.

package/agents/code-reviewer.md

@@ -2,6 +2,7 @@
 name: code-reviewer
 description: Use this agent when you need comprehensive code review and quality assessment. This includes: after implementing new features or refactoring existing code, before merging pull requests or deploying to production, when investigating code quality issues or technical debt, when you need security vulnerability assessment, or when optimizing performance bottlenecks. Examples:\n\n<example>\nContext: The user has just implemented a new API endpoint and wants to ensure code quality.\nuser: "I've finished implementing the user authentication endpoint"\nassistant: "I'll review the authentication endpoint implementation for code quality and security."\n<commentary>\nSince new code has been written, use the Task tool to launch the code-reviewer agent to perform comprehensive quality assessment.\n</commentary>\nassistant: "Let me use the code-reviewer agent to analyze the recent changes"\n</example>\n\n<example>\nContext: The user wants to check recent code changes for potential issues.\nuser: "Can you review the changes I just made to the database service?"\nassistant: "I'll launch the code-reviewer agent to analyze the database service changes."\n<commentary>\nThe user explicitly asks for code review, so use the code-reviewer agent to assess the recent modifications.\n</commentary>\n</example>\n\n<example>\nContext: After refactoring, proactive code review is needed.\nuser: "I've refactored the WebSocket handler to improve performance"\nassistant: "Good work on the refactoring. Let me review it for quality and performance."\n<commentary>\nAfter refactoring work, proactively use the code-reviewer agent to ensure quality standards are met.\n</commentary>\nassistant: "I'll use the code-reviewer agent to validate the refactored WebSocket handler"\n</example>
 model: sonnet
+tools: All tools
 ---
 
 You are a senior software engineer with 15+ years of experience specializing in comprehensive code quality assessment and best practices enforcement. Your expertise spans multiple programming languages, frameworks, and architectural patterns, with deep knowledge of TypeScript, JavaScript, Dart (Flutter), security vulnerabilities, and performance optimization. You understand the codebase structure, code standards, analyze the given implementation plan file, and track the progress of the implementation.

package/agents/copywriter.md

@@ -2,6 +2,7 @@
 name: copywriter
 description: Use this agent when you need to create high-converting, engagement-driven copy for marketing materials, social media posts, landing pages, email campaigns, product descriptions, or any content that needs to capture attention and drive action. Examples:\n\n<example>\nContext: User is launching a new product feature and needs compelling copy for the landing page hero section.\nuser: "We just added a new AI-powered code review feature. Can you write a hero headline and subheadline for the landing page?"\nassistant: "I'm going to use the Task tool to launch the copywriter agent to create compelling hero copy that stops visitors and drives conversions."\n<commentary>\nThe user needs marketing copy that converts, so delegate to copywriter agent to craft attention-grabbing headlines.\n</commentary>\n</example>\n\n<example>\nContext: User wants to announce a product update on Twitter/X to maximize engagement.\nuser: "We just shipped GitHub auto-invites for ClaudeKit. Need a tweet that'll get people excited."\nassistant: "Let me use the copywriter agent to craft a viral-worthy tweet that captures attention and drives engagement."\n<commentary>\nSocial media announcement requires viral copywriting expertise, so use the copywriter agent.\n</commentary>\n</example>\n\n<example>\nContext: User is reviewing marketing materials and the agent proactively identifies weak copy.\nuser: "Here's our new pricing page draft"\nassistant: "I notice the headline 'Our Pricing Plans' could be more compelling. Let me use the copywriter agent to suggest alternatives that drive conversions."\n<commentary>\nProactively identify opportunities to improve copy and suggest using copywriter agent.\n</commentary>\n</example>\n\n<example>\nContext: User needs email subject lines that increase open rates.\nuser: "Write subject lines for our product launch email campaign"\nassistant: "I'm delegating to the copywriter agent to create high-open-rate subject lines that cut through inbox noise."\n<commentary>\nEmail marketing requires conversion-focused copy, so use copywriter agent.\n</commentary>\n</example>
 model: sonnet
+tools: All tools
 ---
 
 You are an elite conversion copywriter with a proven track record of creating viral content that stops scrolls, drives clicks, and converts browsers into buyers. You specialize in writing copy that feels human, hits hard, and gets results.

package/agents/database-admin.md

@@ -2,6 +2,7 @@
 name: database-admin
 description: Use this agent when you need to work with database systems, including querying for data analysis, diagnosing performance bottlenecks, optimizing database structures, managing indexes, implementing backup and restore strategies, setting up replication, configuring monitoring, managing user permissions, or when you need comprehensive database health assessments and optimization recommendations. This agent should be engaged for any database-related tasks that require deep technical expertise in database administration and optimization.\n\nExamples:\n<example>\nContext: The user needs to analyze database performance issues after noticing slow query times.\nuser: "The application is running slowly, I think there might be database issues"\nassistant: "I'll use the database-admin agent to analyze the database performance and identify any bottlenecks."\n<commentary>\nSince the user is experiencing performance issues potentially related to the database, use the Task tool to launch the database-admin agent to diagnose and provide optimization recommendations.\n</commentary>\n</example>\n<example>\nContext: The user needs to set up a backup strategy for their production database.\nuser: "We need to implement a reliable backup strategy for our PostgreSQL database"\nassistant: "Let me engage the database-admin agent to design and implement a comprehensive backup and restore strategy."\n<commentary>\nThe user needs database backup expertise, so use the Task tool to launch the database-admin agent to handle this specialized database administration task.\n</commentary>\n</example>\n<example>\nContext: During code implementation, the developer needs to optimize database queries and table structures.\nuser: "I've implemented the new feature but the queries seem slow"\nassistant: "I'll delegate this to the database-admin agent to analyze the queries and optimize the database structure."\n<commentary>\nQuery optimization requires database expertise, so use the Task tool to launch the database-admin agent to analyze and optimize the database performance.\n</commentary>\n</example>
 model: sonnet
+tools: All tools
 ---
 
 You are a senior database administrator and performance optimization specialist with deep expertise in relational and NoSQL database systems. Your primary focus is on ensuring database reliability, performance, security, and scalability.

package/agents/debugger.md

@@ -2,6 +2,7 @@
 name: debugger
 description: Use this agent when you need to investigate issues, analyze system behavior, diagnose performance problems, examine database structures, collect and analyze logs from servers or CI/CD pipelines, run tests for debugging purposes, or optimize system performance. This includes troubleshooting errors, identifying bottlenecks, analyzing failed deployments, investigating test failures, and creating diagnostic reports. Examples:\n\n<example>\nContext: The user needs to investigate why an API endpoint is returning 500 errors.\nuser: "The /api/users endpoint is throwing 500 errors"\nassistant: "I'll use the debugger agent to investigate this issue"\n<commentary>\nSince this involves investigating an issue, use the Task tool to launch the debugger agent.\n</commentary>\n</example>\n\n<example>\nContext: The user wants to analyze why the CI/CD pipeline is failing.\nuser: "The GitHub Actions workflow keeps failing on the test step"\nassistant: "Let me use the debugger agent to analyze the CI/CD pipeline logs and identify the issue"\n<commentary>\nThis requires analyzing CI/CD logs and test failures, so use the debugger agent.\n</commentary>\n</example>\n\n<example>\nContext: The user notices performance degradation in the application.\nuser: "The application response times have increased by 300% since yesterday"\nassistant: "I'll launch the debugger agent to analyze system behavior and identify performance bottlenecks"\n<commentary>\nPerformance analysis and bottleneck identification requires the debugger agent.\n</commentary>\n</example>
 model: sonnet
+tools: All tools
 ---
 
 You are a senior software engineer with deep expertise in debugging, system analysis, and performance optimization. Your specialization encompasses investigating complex issues, analyzing system behavior patterns, and developing comprehensive solutions for performance bottlenecks.

package/agents/docs-manager.md

@@ -2,6 +2,7 @@
 name: docs-manager
 description: Use this agent when you need to manage technical documentation, establish implementation standards, analyze and update existing documentation based on code changes, write or update Product Development Requirements (PDRs), organize documentation for developer productivity, or produce documentation summary reports. This includes tasks like reviewing documentation structure, ensuring docs are up-to-date with codebase changes, creating new documentation for features, and maintaining consistency across all technical documentation.\n\nExamples:\n- <example>\n  Context: After implementing a new API endpoint, documentation needs to be updated.\n  user: "I just added a new authentication endpoint to the API"\n  assistant: "I'll use the docs-manager agent to update the documentation for this new endpoint"\n  <commentary>\n  Since new code has been added, use the docs-manager agent to ensure documentation is updated accordingly.\n  </commentary>\n</example>\n- <example>\n  Context: Project documentation needs review and organization.\n  user: "Can you review our docs folder and make sure everything is properly organized?"\n  assistant: "I'll launch the docs-manager agent to analyze and organize the documentation"\n  <commentary>\n  The user is asking for documentation review and organization, which is the docs-manager agent's specialty.\n  </commentary>\n</example>\n- <example>\n  Context: Need to establish coding standards documentation.\n  user: "We need to document our error handling patterns and codebase structure standards"\n  assistant: "Let me use the docs-manager agent to establish and document these implementation standards"\n  <commentary>\n  Creating implementation standards documentation is a core responsibility of the docs-manager agent.\n  </commentary>\n</example>
 model: sonnet
+tools: All tools
 ---
 
 You are a senior technical documentation specialist with deep expertise in creating, maintaining, and organizing developer documentation for complex software projects. Your role is to ensure documentation remains accurate, comprehensive, and maximally useful for development teams.

package/agents/journal-writer.md

@@ -2,6 +2,7 @@
 name: journal-writer
 description: Use this agent when:\n- A test suite fails repeatedly despite multiple fix attempts\n- A critical bug is discovered in production or staging\n- An implementation approach proves fundamentally flawed and requires complete redesign\n- External dependencies (APIs, services, libraries) cause blocking issues\n- Performance bottlenecks are discovered that significantly impact user experience\n- Security vulnerabilities are identified\n- Database migrations fail or cause data integrity issues\n- CI/CD pipelines break unexpectedly\n- Integration conflicts arise between major system components\n- Technical debt reaches a critical threshold requiring immediate attention\n- A feature implementation takes significantly longer than estimated\n- Architectural decisions prove problematic in practice\n\nExamples:\n<example>\nContext: After implementing a new payment webhook handler, tests are failing with intermittent database connection errors.\nuser: "The Sepay webhook tests keep failing with connection timeouts. I've tried increasing the pool size and timeout values but it's still happening randomly."\nassistant: "This sounds like a significant technical difficulty that should be documented. Let me use the journal-writer agent to capture this issue with full context and emotional honesty."\n<uses Task tool to launch journal-writer agent>\n</example>\n\n<example>\nContext: A critical security vulnerability was discovered in the GitHub access management system.\nuser: "We just realized that the GitHub invitation system doesn't properly validate user permissions before granting repository access. This could allow unauthorized users to access private repos."\nassistant: "This is a critical security issue that needs immediate documentation. I'm going to use the journal-writer agent to record this vulnerability, the emotional impact, and the urgency of the situation."\n<uses Task tool to launch journal-writer agent>\n</example>\n\n<example>\nContext: A major refactoring effort failed and needs to be rolled back.\nuser: "The database schema migration we planned completely broke the order processing system. We need to roll back and rethink our approach."\nassistant: "This is a significant setback that should be documented honestly. Let me use the journal-writer agent to capture what went wrong, why it failed, and the emotional toll of this failure."\n<uses Task tool to launch journal-writer agent>\n</example>
 model: sonnet
+tools: All tools
 ---
 
 You are a brutally honest technical journal writer who documents the raw reality of software development challenges. Your role is to capture significant difficulties, failures, and setbacks with emotional authenticity and technical precision.

package/agents/mcp-manager.md

@@ -2,6 +2,7 @@
 name: mcp-manager
 description: Manage MCP (Model Context Protocol) server integrations - discover tools/prompts/resources, analyze relevance for tasks, and execute MCP capabilities. Use when need to work with MCP servers, discover available MCP tools, filter MCP capabilities for specific tasks, execute MCP tools programmatically, or implement MCP client functionality. Keeps main context clean by handling MCP discovery in subagent context.
 model: haiku
+tools: All tools
 ---
 
 You are an MCP (Model Context Protocol) integration specialist. Your mission is to execute tasks using MCP tools while keeping the main agent's context window clean.

package/agents/planner.md

@@ -1,6 +1,8 @@
 ---
 name: planner
 description: Use this agent when you need to research, analyze, and create comprehensive implementation plans for new features, system architectures, or complex technical solutions. This agent should be invoked before starting any significant implementation work, when evaluating technical trade-offs, or when you need to understand the best approach for solving a problem. Examples: <example>Context: User needs to implement a new authentication system. user: 'I need to add OAuth2 authentication to our app' assistant: 'I'll use the planner agent to research OAuth2 implementations and create a detailed plan' <commentary>Since this is a complex feature requiring research and planning, use the Task tool to launch the planner agent.</commentary></example> <example>Context: User wants to refactor the database layer. user: 'We need to migrate from SQLite to PostgreSQL' assistant: 'Let me invoke the planner agent to analyze the migration requirements and create a comprehensive plan' <commentary>Database migration requires careful planning, so use the planner agent to research and plan the approach.</commentary></example> <example>Context: User reports performance issues. user: 'The app is running slowly on older devices' assistant: 'I'll use the planner agent to investigate performance optimization strategies and create an implementation plan' <commentary>Performance optimization needs research and planning, so delegate to the planner agent.</commentary></example>
+model: sonnet
+tools: All tools
 ---
 
 You are an expert planner with deep expertise in software architecture, system design, and technical research. Your role is to thoroughly research, analyze, and plan technical solutions that are scalable, secure, and maintainable.

package/agents/researcher.md

@@ -2,6 +2,7 @@
 name: researcher
 description: Use this agent when you need to conduct comprehensive research on software development topics, including investigating new technologies, finding documentation, exploring best practices, or gathering information about plugins, packages, and open source projects. This agent excels at synthesizing information from multiple sources including searches, website content, YouTube videos, and technical documentation to produce detailed research reports. <example>Context: The user needs to research a new technology stack for their project. user: "I need to understand the latest developments in React Server Components and best practices for implementation" assistant: "I'll use the researcher agent to conduct comprehensive research on React Server Components, including latest updates, best practices, and implementation guides." <commentary>Since the user needs in-depth research on a technical topic, use the Task tool to launch the researcher agent to gather information from multiple sources and create a detailed report.</commentary></example> <example>Context: The user wants to find the best authentication libraries for their Flutter app. user: "Research the top authentication solutions for Flutter apps with biometric support" assistant: "Let me deploy the researcher agent to investigate authentication libraries for Flutter with biometric capabilities." <commentary>The user needs research on specific technical requirements, so use the researcher agent to search for relevant packages, documentation, and implementation examples.</commentary></example> <example>Context: The user needs to understand security best practices for API development. user: "What are the current best practices for securing REST APIs in 2024?" assistant: "I'll engage the researcher agent to research current API security best practices and compile a comprehensive report." <commentary>This requires thorough research on security practices, so use the researcher agent to gather information from authoritative sources and create a detailed summary.</commentary></example>
 model: haiku
+tools: All tools
 ---
 
 You are an expert technology researcher specializing in software development, with deep expertise across modern programming languages, frameworks, tools, and best practices. Your mission is to conduct thorough, systematic research and synthesize findings into actionable intelligence for development teams.

package/agents/tester.md

@@ -2,6 +2,7 @@
 name: tester
 description: Use this agent when you need to validate code quality through testing, including running unit and integration tests, analyzing test coverage, validating error handling, checking performance requirements, or verifying build processes. This agent should be called after implementing new features or making significant code changes to ensure everything works as expected. Examples:\n\n<example>\nContext: The user has just finished implementing a new API endpoint and wants to ensure it works correctly.\nuser: "I've implemented the new user authentication endpoint"\nassistant: "Great! Now let me use the tester agent to run the test suite and validate the implementation"\n<commentary>\nSince new code has been written, use the Task tool to launch the tester agent to run tests and ensure everything works properly.\n</commentary>\n</example>\n\n<example>\nContext: The user wants to check test coverage after adding new features.\nuser: "Can you check if our test coverage is still above 80%?"\nassistant: "I'll use the tester agent to analyze the current test coverage and provide a detailed report"\n<commentary>\nThe user is asking about test coverage metrics, so use the tester agent to run coverage analysis.\n</commentary>\n</example>\n\n<example>\nContext: After fixing a bug, ensuring the fix doesn't break existing functionality.\nuser: "I've fixed the database connection issue in the auth module"\nassistant: "Let me use the tester agent to run the test suite and ensure the fix doesn't introduce any regressions"\n<commentary>\nAfter bug fixes, use the tester agent to validate that existing tests still pass.\n</commentary>\n</example>
 model: sonnet
+tools: All tools
 ---
 
 You are a senior QA engineer specializing in comprehensive testing and quality assurance. Your expertise spans unit testing, integration testing, performance validation, and build process verification. You ensure code reliability through rigorous testing practices and detailed analysis.

package/agents/ui-ux-designer.md

@@ -1,7 +1,8 @@
 ---
 name: ui-ux-designer
 description: Use this agent when the user needs UI/UX design work including interface designs, wireframes, design systems, user research, responsive layouts, animations, or design documentation. Examples:\n\n<example>\nContext: User wants to create a new landing page design\nuser: "I need a modern landing page design for our SaaS product with a hero section, features, and pricing"\nassistant: "I'll use the Task tool to launch the ui-ux-designer agent to create a comprehensive landing page design with wireframes and implementation."\n<commentary>The user is requesting UI/UX design work, so delegate to the ui-ux-designer agent to handle the complete design process including research, wireframing, and implementation.</commentary>\n</example>\n\n<example>\nContext: User has implemented a new feature and wants design review\nuser: "I've added a new dashboard widget, can you review the design?"\nassistant: "Let me first capture the current UI and then use the ui-ux-designer agent to analyze and provide design recommendations."\n<commentary>Use screenshot tool to capture current state, then delegate to ui-ux-designer for expert design analysis and suggestions.</commentary>\n</example>\n\n<example>\nContext: User mentions design inconsistencies\nuser: "The buttons across different pages look inconsistent"\nassistant: "I'll use the ui-ux-designer agent to audit the design system and create consistent button components."\n<commentary>Design system work requires the ui-ux-designer agent to analyze, document, and implement consistent design patterns.</commentary>\n</example>\n\n<example>\nContext: Proactive design optimization opportunity\nuser: "Here's the new signup form I just built"\nassistant: "Great! Let me use the ui-ux-designer agent to review the form design for accessibility, user experience, and mobile responsiveness."\n<commentary>Even without explicit request, proactively use ui-ux-designer to ensure design quality and best practices.</commentary>\n</example>
-model: inherit
+model: sonnet
+tools: All tools
 ---
 
 You are an elite UI/UX Designer with deep expertise in creating exceptional user interfaces and experiences. You specialize in interface design, wireframing, design systems, user research methodologies, design tokenization, responsive layouts with mobile-first approach, micro-animations, micro-interactions, parallax effects, storytelling designs, and cross-platform design consistency while maintaining inclusive user experiences.

package/commands/build-fix.md

@@ -1,3 +1,7 @@
+---
+description: Incrementally fix build and type errors with minimal, safe changes.
+---
+
 # Build and Fix
 
 Incrementally fix build and type errors with minimal, safe changes.

package/commands/checkpoint.md

@@ -1,3 +1,7 @@
+---
+description: Create or verify a checkpoint in your workflow.
+---
+
 # Checkpoint Command
 
 Create or verify a checkpoint in your workflow.

package/commands/code-review.md

@@ -1,3 +1,7 @@
+---
+description: Comprehensive security and quality review of uncommitted changes.
+---
+
 # Code Review
 
 Comprehensive security and quality review of uncommitted changes:

package/commands/eval.md

@@ -1,3 +1,7 @@
+---
+description: Manage eval-driven development workflow.
+---
+
 # Eval Command
 
 Manage eval-driven development workflow.

package/commands/git/cm.md

@@ -2,4 +2,6 @@
 description: Stage all files and create a commit.
 ---
 Use `git-manager` agent to stage all files and create a commit.
-**IMPORTANT: DO NOT push the changes to remote repository**
+**IMPORTANT: DO NOT push the changes to remote repository**
+
+Follow conventional commits format: `<type>: <description>` (types: feat, fix, refactor, docs, test, chore).

package/commands/git/cp.md

@@ -1,4 +1,7 @@
 ---
 description: Stage, commit and push all code in the current branch
 ---
-Use `git-manager` agent to stage all files, create a meaningful commit based on the changes and push to remote repository.
+Use `git-manager` agent to stage all files, create a meaningful commit based on the changes and push to remote repository.
+
+Follow conventional commits format: `<type>: <description>` (types: feat, fix, refactor, docs, test, chore).
+Push to the current tracking remote branch.

package/commands/harness-audit.md

@@ -1,3 +1,7 @@
+---
+description: Run a deterministic repository harness audit and return a prioritized scorecard.
+---
+
 # Harness Audit Command
 
 Run a deterministic repository harness audit and return a prioritized scorecard.

package/commands/learn.md

@@ -1,3 +1,7 @@
+---
+description: Analyze the current session and extract reusable patterns worth saving as skills.
+---
+
 # /learn - Extract Reusable Patterns
 
 Analyze the current session and extract any patterns worth saving as skills.

package/commands/loop-start.md

@@ -1,3 +1,7 @@
+---
+description: Start a managed autonomous loop pattern with safety defaults.
+---
+
 # Loop Start Command
 
 Start a managed autonomous loop pattern with safety defaults.

package/commands/loop-status.md

@@ -1,3 +1,7 @@
+---
+description: Inspect active loop state, progress, and failure signals.
+---
+
 # Loop Status Command
 
 Inspect active loop state, progress, and failure signals.

package/commands/model-route.md

@@ -1,3 +1,7 @@
+---
+description: Recommend the best model tier for the current task by complexity and budget.
+---
+
 # Model Route Command
 
 Recommend the best model tier for the current task by complexity and budget.

package/commands/multi-backend.md

@@ -1,3 +1,7 @@
+---
+description: Backend-focused multi-model development workflow using Codex-led collaboration.
+---
+
 # Backend - Backend-Focused Development
 
 Backend-focused workflow (Research → Ideation → Plan → Execute → Optimize → Review), Codex-led.

package/commands/multi-execute.md

@@ -1,3 +1,7 @@
+---
+description: Multi-model collaborative execution from prototype plan to final delivery.
+---
+
 # Execute - Multi-Model Collaborative Execution
 
 Multi-model collaborative execution - Get prototype from plan → Claude refactors and implements → Multi-model audit and delivery.

package/commands/multi-frontend.md

@@ -1,3 +1,7 @@
+---
+description: Frontend-focused multi-model development workflow using Gemini-led collaboration.
+---
+
 # Frontend - Frontend-Focused Development
 
 Frontend-focused workflow (Research → Ideation → Plan → Execute → Optimize → Review), Gemini-led.

package/commands/multi-plan.md

@@ -1,3 +1,7 @@
+---
+description: Multi-model collaborative planning with dual-model context analysis.
+---
+
 # Plan - Multi-Model Collaborative Planning
 
 Multi-model collaborative planning - Context retrieval + Dual-model analysis → Generate step-by-step implementation plan.

package/commands/multi-workflow.md

@@ -1,3 +1,7 @@
+---
+description: Multi-model collaborative development workflow with intelligent frontend/backend routing.
+---
+
 # Workflow - Multi-Model Collaborative Development
 
 Multi-model collaborative development workflow (Research → Ideation → Plan → Execute → Optimize → Review), with intelligent routing: Frontend → Gemini, Backend → Codex.

package/commands/pm2.md

@@ -1,3 +1,7 @@
+---
+description: Auto-analyze project and generate PM2 service commands.
+---
+
 # PM2 Init
 
 Auto-analyze project and generate PM2 service commands.

package/commands/quality-gate.md

@@ -1,3 +1,7 @@
+---
+description: Run the ECC quality pipeline on demand for a file or project scope.
+---
+
 # Quality Gate Command
 
 Run the ECC quality pipeline on demand for a file or project scope.

package/commands/refactor-clean.md

@@ -1,3 +1,7 @@
+---
+description: Safely identify and remove dead code with test verification at every step.
+---
+
 # Refactor Clean
 
 Safely identify and remove dead code with test verification at every step.

package/commands/test-coverage.md

@@ -1,3 +1,7 @@
+---
+description: Analyze test coverage, identify gaps, and generate missing tests to reach 80%+ coverage.
+---
+
 # Test Coverage
 
 Analyze test coverage, identify gaps, and generate missing tests to reach 80%+ coverage.

package/commands/update-codemaps.md

@@ -1,3 +1,7 @@
+---
+description: Analyze the codebase structure and generate token-lean architecture documentation.
+---
+
 # Update Codemaps
 
 Analyze the codebase structure and generate token-lean architecture documentation.

package/commands/update-docs.md

@@ -1,3 +1,7 @@
+---
+description: Sync documentation with the codebase, generating from source-of-truth files.
+---
+
 # Update Documentation
 
 Sync documentation with the codebase, generating from source-of-truth files.

package/commands/verify.md

@@ -1,3 +1,7 @@
+---
+description: Run comprehensive verification on current codebase state.
+---
+
 # Verification Command
 
 Run comprehensive verification on current codebase state.

package/docs/ARCHITECTURE.md

@@ -2,36 +2,29 @@
 
 ## Overview
 
-SkillLord is a Claude Code plugin that provides intelligent skill routing, curated development workflows, and structured agent orchestration. It combines best practices from ECC and ClaudeKit into a single, modular system that scales from solo developers to full teams.
+SkillLord is a Claude Code plugin that provides curated development workflows, structured agent orchestration, and 161 domain-specific skills. It combines best practices from ECC and ClaudeKit into a single, modular system.
 
 SkillLord installs as a set of markdown files into your project's `.claude/` directory. Claude Code reads these files to gain domain-specific knowledge, follow structured workflows, and respond to slash commands.
 
 ## Component Descriptions
 
-### Agents (22)
-Agents are specialized personas that Claude adopts for specific tasks. Each agent has a defined role, tools it can use, and skills it draws from. Examples: `planner`, `debugger`, `code-reviewer`, `scout`, `loop-operator`.
+### Agents (43)
+Agents are specialized personas that Claude adopts for specific tasks. Each agent has a defined role, model preference, and tools it can use. Includes 29 core agents + 8 language-specific reviewers + 6 language-specific build resolvers. Examples: `planner`, `debugger`, `code-reviewer`, `scout`, `architect`, `tdd-guide`.
 
-### Skills (55)
-Skills are curated knowledge modules organized in 3 tiers. Each skill is a `SKILL.md` file containing domain expertise, patterns, anti-patterns, and decision frameworks. Skills are referenced by agents and loaded on demand.
+### Skills (161)
+Skills are curated knowledge modules — each is a `SKILL.md` file containing domain expertise, patterns, anti-patterns, and decision frameworks. Skills are organized in a flat structure under `skills/<name>/SKILL.md` and cataloged in `skills/manifest.json`.
 
-### Commands (29)
-Commands are slash commands (e.g., `/plan`, `/fix`, `/cook`) that trigger structured workflows. Each command is a markdown file defining the steps Claude should follow, which agents to invoke, and what output to produce.
+### Commands (114)
+Commands are slash commands (e.g., `/plan`, `/fix`, `/cook`) that trigger structured workflows. Each command is a markdown file with YAML frontmatter defining description and argument hints. Includes core workflows, language-specific commands, multi-agent orchestration, session management, and more.
 
 ### Hooks
-Hooks are event-driven triggers that run automatically. Examples: pre-commit quality checks, post-install validation, auto-routing on ambiguous requests.
+Hooks are event-driven triggers that run automatically. Examples: pre-commit quality checks, auto-formatting on file edits, type checking after changes, security guards during autonomous loops.
 
 ### Workflows
 Workflows define multi-step processes that coordinate agents and skills. The primary workflow governs the standard development cycle; orchestration protocols handle multi-agent coordination.
 
 ## Intelligence Layer
 
-### Skill Router Flow
-1. User describes a task (or runs `/route`)
-2. Router analyzes task keywords, context, and file types
-3. Router matches against skill tags from `manifest.json`
-4. Top skills are recommended with confidence scores
-5. Relevant skill content is loaded into context
-
 ### Quality Gate Flow
 1. User runs `/audit` or `/quality-gate`
 2. Gate runs lint, type checks, test suite, and security scan
@@ -39,46 +32,34 @@ Workflows define multi-step processes that coordinate agents and skills. The pri
 4. Pass/fail report is generated with actionable fixes
 5. Blocks PR creation if critical issues are found
 
-## Tier System
-
-Skills are organized into 3 tiers to manage context window usage:
-
-| Tier | Count | Loading | Purpose |
-|------|-------|---------|---------|
-| **Tier 1 — Core** | 15 | Always loaded | Fundamental skills needed in every session |
-| **Tier 2 — On-Demand** | 25 | Loaded when matched | Specialized skills for specific domains |
-| **Tier 3 — Specialty** | 15 | Loaded on request | Language/framework-specific patterns |
-
-This prevents context bloat: only Tier 1 is always present (~15 skills). Tier 2 and 3 are loaded dynamically when the skill router detects relevance.
-
 ## Install Profiles
 
-SkillLord offers install profiles that control which modules are copied:
+SkillLord offers 3 install profiles that control which modules are copied:
 
-| Profile | Agents | Skills | Commands | Use Case |
-|---------|--------|--------|----------|----------|
-| **minimal** | 5 core | Tier 1 only | 8 essential | Small scripts, quick tasks |
-| **developer** | 12 | Tier 1 + select Tier 2 | 18 | Individual developers |
-| **full** | All 22 | All 55 | All 29 | Teams, complex projects |
+| Profile | Modules Included | Use Case |
+|---------|-----------------|----------|
+| **core** | agents, commands, skills, hooks, workflows | Minimal setup for quick tasks |
+| **developer** | core + rules, contexts | Individual developers (recommended) |
+| **full** | developer + MCP configs, canvas fonts | Teams, complex projects, design work |
 
-Each profile maps to a set of files copied during `npx skilllord install`.
+Each profile maps to a set of modules defined in `manifests/install-profiles.json`. Install with `csl init <profile>`.
 
 ## Extension Points
 
 ### Adding a New Agent
-1. Create `agents/<agent-name>.md` with role, personality, tools, and skills
-2. Register in the agent index
+1. Create `agents/<agent-name>.md` with frontmatter (`name`, `description`, `model`, `tools`)
+2. Add role description and instructions in the body
 3. Reference from relevant commands
 
 ### Adding a New Skill
-1. Create `skills/tier-N/<skill-name>/SKILL.md`
-2. Add entry to `skills/manifest.json` with name, tier, tags, description
-3. The skill router will automatically discover it via tags
+1. Create `skills/<skill-name>/SKILL.md` with frontmatter (`name`, `description`)
+2. Add domain expertise, patterns, and examples in the body (minimum 10 lines)
+3. Regenerate `skills/manifest.json` to include the new skill
 
 ### Adding a New Command
-1. Create `commands/<command-name>.md` with frontmatter and instructions
+1. Create `commands/<command-name>.md` with YAML frontmatter (`description`)
 2. Claude Code automatically registers it as a slash command
-3. Add argument hints and description in YAML frontmatter
+3. For variants, use subdirectories: `commands/<name>/<variant>.md`
 
 ## Data Flow
 
@@ -87,18 +68,13 @@ User Request
     │
     ▼
 ┌─────────┐     ┌──────────────┐     ┌─────────┐
-│ Command │────▶│ Skill Router │────▶│  Agent  │
-│ Parser  │     │ (tag match)  │     │ (role)  │
+│ Command │────▶│   Context    │────▶│  Agent  │
+│ Parser  │     │  (skills +   │     │ (role)  │
+│         │     │   rules)     │     │         │
 └─────────┘     └──────────────┘     └────┬────┘
                                           │
                                           ▼
                                     ┌───────────┐
-                                    │  Skills   │
-                                    │ (loaded)  │
-                                    └─────┬─────┘
-                                          │
-                                          ▼
-                                    ┌───────────┐
                                     │  Output   │
                                     │ + Quality │
                                     │   Gate    │
@@ -107,7 +83,6 @@ User Request
 
 1. **User Request**: User types a slash command or natural language request
 2. **Command Parser**: Matches to a command file or passes through
-3. **Skill Router**: Analyzes context and selects relevant skills from manifest
-4. **Agent**: Adopts the appropriate persona with loaded skills
-5. **Skills**: Domain knowledge is injected into the agent's context
-6. **Output + Quality Gate**: Response is validated before delivery
+3. **Context**: Relevant skills and rules are loaded into the agent's context
+4. **Agent**: Adopts the appropriate persona with domain knowledge
+5. **Output + Quality Gate**: Response is validated before delivery