@atlashub/smartstack-cli 3.39.0 → 3.41.0

package/templates/skills/cc-agent/templates/agent-with-skills.md

@@ -1,94 +1,94 @@
-# Template: Agent with Preloaded Skills
-
-Use this template for agents that need skills injected at startup for domain knowledge.
-
-## Generated agent file format:
-
-```yaml
----
-name: {{AGENT_NAME}}
-description: {{DESCRIPTION}}
-{{#if MODEL}}
-model: {{MODEL}}
-{{/if}}
-{{#if TOOLS}}
-tools: "{{TOOLS}}"
-{{/if}}
-{{#if PERMISSION_MODE}}
-permissionMode: {{PERMISSION_MODE}}
-{{/if}}
-skills:
-{{#each SKILLS}}
-  - {{this}}
-{{/each}}
-{{#if COLOR}}
-color: {{COLOR}}
-{{/if}}
----
-
-{{SYSTEM_PROMPT}}
-
-## Preloaded Knowledge
-
-This agent has the following skills preloaded for domain expertise:
-{{#each SKILLS}}
-- **{{this}}**: Provides knowledge about {{SKILL_PURPOSE}}
-{{/each}}
-
-## Workflow
-
-1. **{{STEP_1_NAME}}**: {{STEP_1_DESC}}
-2. **{{STEP_2_NAME}}**: {{STEP_2_DESC}}
-3. **{{STEP_3_NAME}}**: {{STEP_3_DESC}}
-
-## Execution Rules
-
-- {{RULE_1}}
-- {{RULE_2}}
-- Always reference preloaded skill knowledge when applicable
-- {{RULE_3}}
-
-## Output Format
-
-{{OUTPUT_FORMAT_DESCRIPTION}}
-```
-
-## How Skills Preloading Works:
-- The `skills` field injects the FULL content of each listed skill into the agent's context at startup
-- This gives the agent domain-specific knowledge without needing to search for it
-- Increases initial context size but improves response quality
-- Skills must exist in the same scope or a higher-priority scope
-
-## When to Use:
-- Agent needs deep domain knowledge (e.g., code reviewer needs review-code skill)
-- Agent operates in a specific framework context
-- Agent needs access to conventions and patterns
-- Agent should follow specific workflows defined in skills
-
-## Considerations:
-- Each preloaded skill adds to context size
-- Limit to 1-3 skills for optimal performance
-- Prefer specific skills over broad ones
-- Ensure skills are relevant to the agent's purpose
-
-## Example:
-```yaml
----
-name: smartstack-reviewer
-description: Code reviewer specialized in SmartStack conventions
-model: sonnet
-tools: "Read, Grep, Glob"
-permissionMode: plan
-skills:
-  - review-code
-  - validate
----
-
-You are a SmartStack-aware code reviewer. Use the preloaded review-code
-and validate skills to check code against SmartStack conventions.
-```
-
-## Notes:
-- The code-reviewer agent in SmartStack uses this pattern (loads review-code skill)
-- Keep the number of preloaded skills minimal (1-3)
-- Agent description should mention the specialized knowledge area
+# Template: Agent with Preloaded Skills
+
+Use this template for agents that need skills injected at startup for domain knowledge.
+
+## Generated agent file format:
+
+```yaml
+---
+name: {{AGENT_NAME}}
+description: {{DESCRIPTION}}
+{{#if MODEL}}
+model: {{MODEL}}
+{{/if}}
+{{#if TOOLS}}
+tools: "{{TOOLS}}"
+{{/if}}
+{{#if PERMISSION_MODE}}
+permissionMode: {{PERMISSION_MODE}}
+{{/if}}
+skills:
+{{#each SKILLS}}
+  - {{this}}
+{{/each}}
+{{#if COLOR}}
+color: {{COLOR}}
+{{/if}}
+---
+
+{{SYSTEM_PROMPT}}
+
+## Preloaded Knowledge
+
+This agent has the following skills preloaded for domain expertise:
+{{#each SKILLS}}
+- **{{this}}**: Provides knowledge about {{SKILL_PURPOSE}}
+{{/each}}
+
+## Workflow
+
+1. **{{STEP_1_NAME}}**: {{STEP_1_DESC}}
+2. **{{STEP_2_NAME}}**: {{STEP_2_DESC}}
+3. **{{STEP_3_NAME}}**: {{STEP_3_DESC}}
+
+## Execution Rules
+
+- {{RULE_1}}
+- {{RULE_2}}
+- Always reference preloaded skill knowledge when applicable
+- {{RULE_3}}
+
+## Output Format
+
+{{OUTPUT_FORMAT_DESCRIPTION}}
+```
+
+## How Skills Preloading Works:
+- The `skills` field injects the FULL content of each listed skill into the agent's context at startup
+- This gives the agent domain-specific knowledge without needing to search for it
+- Increases initial context size but improves response quality
+- Skills must exist in the same scope or a higher-priority scope
+
+## When to Use:
+- Agent needs deep domain knowledge (e.g., code reviewer needs review-code skill)
+- Agent operates in a specific framework context
+- Agent needs access to conventions and patterns
+- Agent should follow specific workflows defined in skills
+
+## Considerations:
+- Each preloaded skill adds to context size
+- Limit to 1-3 skills for optimal performance
+- Prefer specific skills over broad ones
+- Ensure skills are relevant to the agent's purpose
+
+## Example:
+```yaml
+---
+name: smartstack-reviewer
+description: Code reviewer specialized in SmartStack conventions
+model: sonnet
+tools: "Read, Grep, Glob"
+permissionMode: plan
+skills:
+  - review-code
+  - validate
+---
+
+You are a SmartStack-aware code reviewer. Use the preloaded review-code
+and validate skills to check code against SmartStack conventions.
+```
+
+## Notes:
+- The code-reviewer agent in SmartStack uses this pattern (loads review-code skill)
+- Keep the number of preloaded skills minimal (1-3)
+- Agent description should mention the specialized knowledge area

package/templates/skills/cc-audit/SKILL.md

@@ -1,108 +1,108 @@
----
-name: cc-audit
-description: |
-  Audit Claude Code components (skills, agents, hooks, settings).
-  Use this skill when:
-  - Checking component health and conventions
-  - Inventorying all components in a project
-  - Validating structure before deployment
-  - Verifying cross-references between components
-argument-hint: "[project|global|templates]"
-disable-model-invocation: true
----
-
-<objective>
-Audit all Claude Code components (skills, agents, hooks, settings) in a given scope, validate their structure against official conventions, and generate a comprehensive report with actionable recommendations.
-</objective>
-
-<quick_start>
-
-```bash
-/cc-audit                  # Audit current project (.claude/)
-/cc-audit project          # Audit project-level components
-/cc-audit global           # Audit user-level (~/.claude/)
-/cc-audit templates        # Audit SmartStack CLI templates/
-/cc-audit all              # Audit all scopes
-```
-
-</quick_start>
-
-<parameters>
-
-<flags>
-| Flag | Description |
-|------|-------------|
-| `project` | Scan `.claude/` in current working directory |
-| `global` | Scan `~/.claude/` (user-level) |
-| `templates` | Scan `templates/` (SmartStack CLI source) |
-| `all` | Scan all scopes |
-| `--fix` | Attempt auto-fix of common issues |
-| `--verbose` | Show detailed validation per component |
-</flags>
-
-<examples>
-```bash
-# Quick health check
-/cc-audit
-
-# Full audit with details
-/cc-audit all --verbose
-
-# Audit and fix issues
-/cc-audit project --fix
-```
-</examples>
-
-</parameters>
-
-<workflow>
-1. Parse scope and flags
-2. Scan directories for all components
-3. Validate each component against official conventions
-4. Check cross-references (skills ↔ agents, hooks ↔ scripts)
-5. Generate audit report with status and recommendations
-</workflow>
-
-<state_variables>
-| Variable | Type | Description |
-|----------|------|-------------|
-| `{scope}` | string | project, global, templates, or all |
-| `{fix_mode}` | boolean | Auto-fix common issues |
-| `{verbose}` | boolean | Show detailed output |
-| `{scan_paths}` | string[] | Directories to scan |
-| `{skills_found}` | object[] | Skills inventory |
-| `{agents_found}` | object[] | Agents inventory |
-| `{hooks_found}` | object[] | Hooks inventory |
-| `{issues}` | object[] | All issues found |
-</state_variables>
-
-<entry_point>
-
-**FIRST ACTION:** Load `steps/step-00-init.md`
-
-</entry_point>
-
-<step_files>
-| Step | File | Purpose |
-|------|------|---------|
-| 00 | `steps/step-00-init.md` | Parse scope, detect environment, resolve paths |
-| 01 | `steps/step-01-scan.md` | Scan all components in target directories |
-| 02 | `steps/step-02-analyze.md` | Validate structure, frontmatter, cross-references |
-| 03 | `steps/step-03-report.md` | Generate audit report with recommendations |
-</step_files>
-
-<execution_rules>
-- **Load one step at a time** - Progressive loading
-- **Non-destructive** - Read-only unless --fix is set
-- **Comprehensive** - Check ALL components, not just a sample
-- **Actionable** - Every issue must have a clear recommendation
-- **Reference official docs** - Base all checks on Claude Code documentation
-</execution_rules>
-
-<success_criteria>
-- All components in scope are inventoried
-- Each component validated against official conventions
-- Cross-references verified (no broken links)
-- Clear report with status per component
-- Actionable recommendations for each issue
-</success_criteria>
+---
+name: cc-audit
+description: |
+  Audit Claude Code components (skills, agents, hooks, settings).
+  Use this skill when:
+  - Checking component health and conventions
+  - Inventorying all components in a project
+  - Validating structure before deployment
+  - Verifying cross-references between components
+argument-hint: "[project|global|templates]"
+disable-model-invocation: true
+---
+
+<objective>
+Audit all Claude Code components (skills, agents, hooks, settings) in a given scope, validate their structure against official conventions, and generate a comprehensive report with actionable recommendations.
+</objective>
+
+<quick_start>
+
+```bash
+/cc-audit                  # Audit current project (.claude/)
+/cc-audit project          # Audit project-level components
+/cc-audit global           # Audit user-level (~/.claude/)
+/cc-audit templates        # Audit SmartStack CLI templates/
+/cc-audit all              # Audit all scopes
+```
+
+</quick_start>
+
+<parameters>
+
+<flags>
+| Flag | Description |
+|------|-------------|
+| `project` | Scan `.claude/` in current working directory |
+| `global` | Scan `~/.claude/` (user-level) |
+| `templates` | Scan `templates/` (SmartStack CLI source) |
+| `all` | Scan all scopes |
+| `--fix` | Attempt auto-fix of common issues |
+| `--verbose` | Show detailed validation per component |
+</flags>
+
+<examples>
+```bash
+# Quick health check
+/cc-audit
+
+# Full audit with details
+/cc-audit all --verbose
+
+# Audit and fix issues
+/cc-audit project --fix
+```
+</examples>
+
+</parameters>
+
+<workflow>
+1. Parse scope and flags
+2. Scan directories for all components
+3. Validate each component against official conventions
+4. Check cross-references (skills ↔ agents, hooks ↔ scripts)
+5. Generate audit report with status and recommendations
+</workflow>
+
+<state_variables>
+| Variable | Type | Description |
+|----------|------|-------------|
+| `{scope}` | string | project, global, templates, or all |
+| `{fix_mode}` | boolean | Auto-fix common issues |
+| `{verbose}` | boolean | Show detailed output |
+| `{scan_paths}` | string[] | Directories to scan |
+| `{skills_found}` | object[] | Skills inventory |
+| `{agents_found}` | object[] | Agents inventory |
+| `{hooks_found}` | object[] | Hooks inventory |
+| `{issues}` | object[] | All issues found |
+</state_variables>
+
+<entry_point>
+
+**FIRST ACTION:** Load `steps/step-00-init.md`
+
+</entry_point>
+
+<step_files>
+| Step | File | Purpose |
+|------|------|---------|
+| 00 | `steps/step-00-init.md` | Parse scope, detect environment, resolve paths |
+| 01 | `steps/step-01-scan.md` | Scan all components in target directories |
+| 02 | `steps/step-02-analyze.md` | Validate structure, frontmatter, cross-references |
+| 03 | `steps/step-03-report.md` | Generate audit report with recommendations |
+</step_files>
+
+<execution_rules>
+- **Load one step at a time** - Progressive loading
+- **Non-destructive** - Read-only unless --fix is set
+- **Comprehensive** - Check ALL components, not just a sample
+- **Actionable** - Every issue must have a clear recommendation
+- **Reference official docs** - Base all checks on Claude Code documentation
+</execution_rules>
+
+<success_criteria>
+- All components in scope are inventoried
+- Each component validated against official conventions
+- Cross-references verified (no broken links)
+- Clear report with status per component
+- Actionable recommendations for each issue
+</success_criteria>

package/templates/skills/cc-audit/references/agent-checklist.md

@@ -1,91 +1,91 @@
-# Agent Validation Checklist
-
-Based on official Claude Code documentation: https://code.claude.com/docs/en/sub-agents
-
-## Required
-
-- [ ] Agent file is a `.md` file with YAML frontmatter
-- [ ] Frontmatter contains `name` (unique identifier)
-- [ ] Frontmatter contains `description` (when Claude should delegate to this agent)
-
-## Recommended
-
-- [ ] `description` is clear enough for Claude to decide when to delegate
-- [ ] `model` specified appropriately:
-  - `haiku` for fast, read-only tasks
-  - `sonnet` for balanced tasks
-  - `opus` for complex reasoning
-  - `inherit` to use parent's model
-- [ ] `tools` explicitly lists needed tools (principle of least privilege)
-- [ ] `permissionMode` set appropriately for the agent's task
-
-## Structure
-
-- [ ] File located in correct directory:
-  - `.claude/agents/` for project-level
-  - `~/.claude/agents/` for user-level
-  - `.claude/agents/{category}/` for categorized agents
-- [ ] Content includes clear system prompt
-- [ ] Content describes workflow/steps
-- [ ] Content defines execution rules
-- [ ] Content specifies output format
-
-## Tool Access
-
-- [ ] `tools` field only includes necessary tools
-- [ ] `disallowedTools` used to explicitly block dangerous tools if needed
-- [ ] MCP tools referenced correctly (mcp__{server}__{tool})
-
-## Permission Modes
-
-| Mode | Use Case | Risk |
-|------|----------|------|
-| `default` | Standard interactive work | Low |
-| `acceptEdits` | Automated file modifications | Medium |
-| `dontAsk` | Background tasks that should not prompt | Medium |
-| `bypassPermissions` | Full automation (trusted agents only) | HIGH |
-| `plan` | Read-only exploration and research | None |
-
-## Skills Preloading
-
-- [ ] `skills` field references existing skill names
-- [ ] Referenced skills are relevant to agent's purpose
-- [ ] Not overloading agent with too many preloaded skills
-
-## Hooks (if applicable)
-
-- [ ] Hook events are valid lifecycle events
-- [ ] Hook matchers use valid regex
-- [ ] Hook commands reference existing scripts
-- [ ] Hooks are scoped to agent's responsibilities
-
-## Content Quality
-
-- [ ] System prompt is actionable (not vague)
-- [ ] Workflow has numbered steps
-- [ ] Execution rules define clear constraints
-- [ ] Output format is specified
-- [ ] Agent doesn't duplicate functionality of built-in agents
-
-## Built-in Agents (do not recreate)
-
-| Agent | Purpose | Model |
-|-------|---------|-------|
-| Explore | Fast codebase search, read-only | haiku |
-| Plan | Research and design, read-only | inherit |
-| general-purpose | Complex multi-step tasks | inherit |
-| Bash | Command execution in separate context | inherit |
-
-## Frontmatter Fields Reference
-
-| Field | Type | Required | Default | Description |
-|-------|------|----------|---------|-------------|
-| `name` | string | YES | - | Unique agent identifier |
-| `description` | string | YES | - | When to delegate to this agent |
-| `tools` | string | no | all | CSV of available tools |
-| `disallowedTools` | string | no | - | CSV of blocked tools |
-| `model` | string | no | inherit | haiku/sonnet/opus/inherit |
-| `permissionMode` | string | no | default | Permission handling mode |
-| `skills` | list | no | - | Skills to preload |
-| `hooks` | object | no | - | Agent-scoped lifecycle hooks |
-| `color` | string | no | - | Visual indicator color |
+# Agent Validation Checklist
+
+Based on official Claude Code documentation: https://code.claude.com/docs/en/sub-agents
+
+## Required
+
+- [ ] Agent file is a `.md` file with YAML frontmatter
+- [ ] Frontmatter contains `name` (unique identifier)
+- [ ] Frontmatter contains `description` (when Claude should delegate to this agent)
+
+## Recommended
+
+- [ ] `description` is clear enough for Claude to decide when to delegate
+- [ ] `model` specified appropriately:
+  - `haiku` for fast, read-only tasks
+  - `sonnet` for balanced tasks
+  - `opus` for complex reasoning
+  - `inherit` to use parent's model
+- [ ] `tools` explicitly lists needed tools (principle of least privilege)
+- [ ] `permissionMode` set appropriately for the agent's task
+
+## Structure
+
+- [ ] File located in correct directory:
+  - `.claude/agents/` for project-level
+  - `~/.claude/agents/` for user-level
+  - `.claude/agents/{category}/` for categorized agents
+- [ ] Content includes clear system prompt
+- [ ] Content describes workflow/steps
+- [ ] Content defines execution rules
+- [ ] Content specifies output format
+
+## Tool Access
+
+- [ ] `tools` field only includes necessary tools
+- [ ] `disallowedTools` used to explicitly block dangerous tools if needed
+- [ ] MCP tools referenced correctly (mcp__{server}__{tool})
+
+## Permission Modes
+
+| Mode | Use Case | Risk |
+|------|----------|------|
+| `default` | Standard interactive work | Low |
+| `acceptEdits` | Automated file modifications | Medium |
+| `dontAsk` | Background tasks that should not prompt | Medium |
+| `bypassPermissions` | Full automation (trusted agents only) | HIGH |
+| `plan` | Read-only exploration and research | None |
+
+## Skills Preloading
+
+- [ ] `skills` field references existing skill names
+- [ ] Referenced skills are relevant to agent's purpose
+- [ ] Not overloading agent with too many preloaded skills
+
+## Hooks (if applicable)
+
+- [ ] Hook events are valid lifecycle events
+- [ ] Hook matchers use valid regex
+- [ ] Hook commands reference existing scripts
+- [ ] Hooks are scoped to agent's responsibilities
+
+## Content Quality
+
+- [ ] System prompt is actionable (not vague)
+- [ ] Workflow has numbered steps
+- [ ] Execution rules define clear constraints
+- [ ] Output format is specified
+- [ ] Agent doesn't duplicate functionality of built-in agents
+
+## Built-in Agents (do not recreate)
+
+| Agent | Purpose | Model |
+|-------|---------|-------|
+| Explore | Fast codebase search, read-only | haiku |
+| Plan | Research and design, read-only | inherit |
+| general-purpose | Complex multi-step tasks | inherit |
+| Bash | Command execution in separate context | inherit |
+
+## Frontmatter Fields Reference
+
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| `name` | string | YES | - | Unique agent identifier |
+| `description` | string | YES | - | When to delegate to this agent |
+| `tools` | string | no | all | CSV of available tools |
+| `disallowedTools` | string | no | - | CSV of blocked tools |
+| `model` | string | no | inherit | haiku/sonnet/opus/inherit |
+| `permissionMode` | string | no | default | Permission handling mode |
+| `skills` | list | no | - | Skills to preload |
+| `hooks` | object | no | - | Agent-scoped lifecycle hooks |
+| `color` | string | no | - | Visual indicator color |