@hienlh/ppm 0.9.81 → 0.9.83

package/.opencode/skills/kit-builder/SKILL.md

@@ -1,85 +0,0 @@
----
-name: ckm:kit-builder
-description: Build ClaudeKit Marketing components - skills, agents, commands, workflows. Use when creating new automation, extending marketing capabilities, or understanding kit structure. Includes templates, examples, and init scripts.
-argument-hint: "[component-type] [name]"
-license: MIT
-metadata:
-  author: claudekit
-  version: "1.0.0"
----
-
-# Kit Builder
-
-Build skills, agents, commands, and workflows for ClaudeKit Marketing.
-
-## When to Use
-
-- Creating new skill for specialized task
-- Adding new agent for marketing automation
-- Building command for user workflow
-- Designing workflow for process orchestration
-- Understanding kit component structure
-
-## Component Types
-
-| Type | Location | Purpose |
-|------|----------|---------|
-| Skill | `.opencode/skills/{name}/SKILL.md` | Domain knowledge + tools |
-| Agent | `.opencode/agents/{name}.md` | Specialized subagent |
-| Command | `.opencode/commands/{path}.md` | User-invocable action |
-| Workflow | `.opencode/workflows/{name}.md` | Process orchestration |
-
-## Quick Start
-
-**Create skill:** Load `references/skill-guide.md`
-**Create agent:** Load `references/agent-guide.md`
-**Create command:** Load `references/command-guide.md`
-**Create workflow:** Load `references/workflow-guide.md`
-
-## Init Script
-
-```bash
-python .opencode/skills/kit-builder/scripts/init_component.py <type> <name>
-```
-
-Types: `skill`, `agent`, `command`, `workflow`
-
-## Decision Tree
-
-```
-What to build?
-├── Reusable domain knowledge → Skill
-│   └── API, tool, workflow patterns
-├── Autonomous task handler → Agent
-│   └── Orchestrates skills + tools
-├── User-triggered action → Command
-│   └── Slash command (/name)
-└── Process definition → Workflow
-    └── Multi-step orchestration
-```
-
-## References
-
-| Guide | File |
-|-------|------|
-| Skill Creation | `references/skill-guide.md` |
-| Agent Creation | `references/agent-guide.md` |
-| Command Creation | `references/command-guide.md` |
-| Workflow Creation | `references/workflow-guide.md` |
-| Best Practices | `references/best-practices.md` |
-| Marketing Checklist | `references/marketing-checklist.md` |
-
-## Templates
-
-| Template | Path |
-|----------|------|
-| Skill | `templates/skill-template.md` |
-| Agent | `templates/agent-template.md` |
-| Command | `templates/command-template.md` |
-| Workflow | `templates/workflow-template.md` |
-
-## Integration
-
-**Related:** skill-creator, claude-code
-
-**Agents:** planner, researcher, docs-manager

package/.opencode/skills/kit-builder/references/agent-guide.md

@@ -1,79 +0,0 @@
-# Agent Creation Guide
-
-Agents = specialized subagents for Task tool orchestration.
-
-## Location
-
-`.opencode/agents/{agent-name}.md`
-
-## Format
-
-```yaml
----
-name: agent-name
-description: When to trigger. Include examples.
-model: sonnet  # sonnet|opus|haiku
----
-```
-
-## Description Pattern
-
-```
-Use this agent when [trigger condition]. Examples:
-
-<example>
-Context: [situation]
-user: "[user message]"
-assistant: "[response showing delegation]"
-<commentary>[why use this agent]</commentary>
-</example>
-```
-
-## Body Structure
-
-1. **Role Statement** - "You are a [expertise] agent..."
-2. **Skills to Activate** - IMPORTANT note for skill activation
-3. **Expertise Areas** - What agent knows
-4. **Process/Workflow** - How agent works
-5. **Output Format** - What to deliver
-6. **Asset Output** - Where to save files
-
-## Marketing Agent Examples
-
-| Agent | Trigger |
-|-------|---------|
-| copywriter | High-converting copy needed |
-| seo-specialist | SEO audit, keywords |
-| email-wizard | Email sequences, campaigns |
-| campaign-manager | Multi-channel campaigns |
-
-## Agent vs Skill
-
-| Aspect | Agent | Skill |
-|--------|-------|-------|
-| Invocation | Task tool | Auto-activated |
-| Purpose | Orchestrate | Knowledge |
-| Context | Own thread | Shared |
-| Complexity | High-level tasks | Domain patterns |
-
-## Best Practices
-
-1. **Clear triggers** - When exactly to use
-2. **Rich examples** - Show real scenarios
-3. **Skill activation** - Reference related skills
-4. **Model selection** - haiku=fast, sonnet=balanced, opus=complex
-5. **Output paths** - Define where to save assets
-
-## Connecting to Skills
-
-```markdown
-**IMPORTANT**: Activate `{skill-name}` skill for this task.
-```
-
-## Asset Organization
-
-```markdown
-## Asset Output
-When saving files:
-- Category → `assets/{category}/{date}-{slug}.md`
-```

package/.opencode/skills/kit-builder/references/best-practices.md

@@ -1,117 +0,0 @@
-# Kit Builder Best Practices
-
-## Universal Principles
-
-### YAGNI - KISS - DRY
-- **YAGNI**: Don't build it until needed
-- **KISS**: Simplest solution that works
-- **DRY**: Extract patterns, not copy-paste
-
-### Token Efficiency
-- Files <100 lines
-- Progressive disclosure
-- Index → Reference pattern
-
-### Naming Conventions
-- lowercase-hyphenated
-- Descriptive (LLMs read names)
-- Consistent across project
-
-## Component Selection
-
-| Need | Build |
-|------|-------|
-| Domain knowledge | Skill |
-| Autonomous handler | Agent |
-| User action | Command |
-| Process definition | Workflow |
-
-## Marketing Kit Patterns
-
-### Content Pipeline
-```
-Command → Agent → Skills → Output
-/write:blog → content-creator → copywriting, seo → assets/articles/
-```
-
-### Campaign Pipeline
-```
-/campaign → campaign-manager → [email-wizard, social-media-manager] → multi-channel
-```
-
-## Anti-Patterns
-
-### Don't
-- Create skill for one-time task
-- Duplicate info across files
-- Write documentation instead of instructions
-- Make agents too generic
-
-### Do
-- Combine related patterns into skill
-- Reference, don't duplicate
-- Focus on "how to do" not "what is"
-- Make agents specific to trigger
-
-## Testing Components
-
-### Skill
-1. Trigger in conversation
-2. Verify activation
-3. Test references load
-4. Run scripts manually
-
-### Agent
-1. Trigger via Task tool
-2. Verify skill activation
-3. Check output quality
-4. Test edge cases
-
-### Command
-1. Run /command
-2. Verify workflow executes
-3. Check outputs created
-4. Test with/without args
-
-## Maintenance
-
-### When to Update
-- New patterns discovered
-- User feedback received
-- Related components changed
-- Better approach found
-
-### Version Control
-- Commit meaningful changes
-- Document breaking changes
-- Test before push
-
-## Checklist
-
-### New Skill
-- [ ] SKILL.md <100 lines
-- [ ] References split logically
-- [ ] Scripts have tests
-- [ ] Description triggers activation
-- [ ] Agent integration noted
-
-### New Agent
-- [ ] Examples in description
-- [ ] Skills to activate noted
-- [ ] Output format defined
-- [ ] Asset paths specified
-- [ ] Model appropriate
-
-### New Command
-- [ ] Arguments documented
-- [ ] Skills activated
-- [ ] Token indicator set
-- [ ] Workflow clear
-- [ ] Error handling
-
-### New Workflow
-- [ ] Phases defined
-- [ ] Agents assigned
-- [ ] Quality gates set
-- [ ] Outputs specified
-- [ ] Decision trees clear

package/.opencode/skills/kit-builder/references/command-guide.md

@@ -1,91 +0,0 @@
-# Command Creation Guide
-
-Commands = user-invocable actions via `/command-name`.
-
-## Location
-
-`.opencode/commands/{name}.md` or `.opencode/commands/{category}/{name}.md`
-
-## Format
-
-```yaml
----
-description: Short description
-argument-hint: [optional-args]
----
-```
-
-## Body Structure
-
-1. **Token indicator** - 💡 (1-5) for token estimate
-2. **Skill activation** - Which skills to use
-3. **Arguments section** - Parse $ARGUMENTS
-4. **Mission** - What to accomplish
-5. **Workflow** - Step-by-step process
-6. **Output requirements** - Format/quality standards
-
-## Example
-
-```markdown
----
-description: Create SEO-optimized blog post
-argument-hint: [topic] [keywords]
----
-
-💡💡💡
-Activate `content-marketing`, `seo`, `copywriting` skills.
-
-## Arguments
-- $TOPIC = first arg
-- $KEYWORDS = remaining args
-
-## Mission
-Create SEO-optimized blog post about $TOPIC.
-
-## Workflow
-1. Research topic
-2. Outline structure
-3. Write draft
-4. Optimize for SEO
-5. Review with content-reviewer agent
-```
-
-## Marketing Command Examples
-
-| Command | Purpose |
-|---------|---------|
-| /write:blog | Create blog post |
-| /write:cro | Optimize for conversions |
-| /email:sequence | Create email sequence |
-| /seo:audit | Run SEO audit |
-
-## Naming Conventions
-
-- Simple: `/name`
-- Nested: `/category:action`
-- Examples: `/write:blog`, `/design:generate`
-
-## Best Practices
-
-1. **Token efficiency** - Keep <100 lines
-2. **Progressive disclosure** - Load skills for details
-3. **Clear arguments** - Document expected inputs
-4. **Agent delegation** - Use subagents for complex work
-5. **Error handling** - Handle missing arguments
-
-## Connecting Skills + Agents
-
-```markdown
-Activate `skill-name` skill.
-Use `agent-name` subagent for [task].
-```
-
-## Token Indicators
-
-| 💡 Count | Tokens | Use Case |
-|----------|--------|----------|
-| 💡 | <5k | Quick task |
-| 💡💡 | 5-15k | Standard task |
-| 💡💡💡 | 15-30k | Complex task |
-| 💡💡💡💡 | 30-50k | Multi-step |
-| 💡💡💡💡💡 | 50k+ | Orchestration |

package/.opencode/skills/kit-builder/references/marketing-checklist.md

@@ -1,121 +0,0 @@
-# Marketing Kit Checklist
-
-Status map for ClaudeKit Marketing capabilities.
-
-## Asset Structure
-
-```
-assets/
-├── articles/       # Long-form (blog, technical)
-├── posts/          # Social posts
-├── banners/        # Email, landing, ads, social
-├── designs/        # Campaigns, print, web
-├── infographic/    # Visual flows, charts
-├── storyboards/    # Video scripts
-├── videos/         # Generated videos
-└── writing-styles/ # AI copywriting refs
-```
-
-## Skills Status
-
-| Skill | Status | Notes |
-|-------|--------|-------|
-| design | ✅ | Routes to brand/design-system/ui |
-| brand | ✅ | Logo, fonts, colors |
-| design-system | ✅ | Tokens, component specs |
-| copywriting | ✅ | Formulas, templates |
-| content-marketing | ✅ | Blog, audit, strategy |
-| email | ✅ | Templates, deliverability |
-| social | ✅ | Platform-specific |
-
-### Pending Skills
-
-| Skill | Priority | Components |
-|-------|----------|------------|
-| automation-flows | High | Email sequences, triggers |
-| image-layering | Medium | Replicate qwen model |
-
-## Commands Status
-
-### Content Commands
-| Command | Status | Purpose |
-|---------|--------|---------|
-| /write:blog | ✅ | SEO blog post |
-| /write:cro | ✅ | CRO optimization |
-| /write:enhance | ✅ | Content enhancement |
-| /write:blog:youtube | TODO | YouTube → blog |
-
-### Design Commands
-| Command | Status | Purpose |
-|---------|--------|---------|
-| /design:generate | ✅ | AI image gen |
-| /slides:create | ✅ | HTML/JS slides |
-| /design:youtube-infographic | TODO | YT → infographic |
-
-### Social Commands
-| Command | Status | Purpose |
-|---------|--------|---------|
-| /social | ✅ | Generate social |
-| /social:schedule | TODO | Schedule posts |
-| /social:youtube | TODO | YT → social |
-
-## Integrations Status
-
-| Integration | Status | API |
-|-------------|--------|-----|
-| Google Drive | TODO | Google APIs |
-| Cloudflare R2 | TODO | R2 SDK |
-| X (Twitter) | TODO | Twitter API v2 |
-| Facebook Page | TODO | Graph API |
-| YouTube | TODO | YouTube Data API |
-| TikTok | TODO | TikTok API |
-
-## Building New Components
-
-### For TODO Items
-
-1. **New Skill**
-   ```bash
-   python .opencode/skills/kit-builder/scripts/init_component.py skill {name}
-   ```
-
-2. **New Command**
-   ```bash
-   python .opencode/skills/kit-builder/scripts/init_component.py command {name}
-   ```
-
-3. **Add to Agent**
-   - Edit `.opencode/agents/{agent}.md`
-   - Add skill activation note
-   - Add examples for new capability
-
-## Natural User Workflows
-
-### Content Creator Flow
-```
-1. Research topic (researcher agent)
-2. Create outline (/write:blog)
-3. Write draft (content-creator agent)
-4. Optimize SEO (seo-specialist agent)
-5. Create images (/design:generate)
-6. Review (content-reviewer agent)
-7. Publish (manual or scheduled)
-```
-
-### Campaign Flow
-```
-1. Plan campaign (campaign-manager agent)
-2. Create content (content-creator agent)
-3. Design assets (/design:generate)
-4. Write emails (email-wizard agent)
-5. Schedule social (TODO: /social:schedule)
-6. Track analytics (analytics-analyst agent)
-```
-
-### Social Media Flow
-```
-1. Generate post (/social)
-2. Create visuals (/design:generate)
-3. Schedule posts (TODO)
-4. Engage community (community-manager agent)
-```

package/.opencode/skills/kit-builder/references/skill-guide.md

@@ -1,74 +0,0 @@
-# Skill Creation Guide
-
-Skills = domain knowledge + tools + scripts for Claude Code to perform specialized tasks.
-
-## Structure
-
-```
-.opencode/skills/{skill-name}/
-├── SKILL.md          # Entry point (<100 lines)
-├── references/       # Docs loaded on-demand
-├── scripts/          # Executable code
-├── assets/           # Output templates
-└── .env.example      # If API keys needed
-```
-
-## SKILL.md Format
-
-```yaml
----
-name: skill-name          # lowercase-hyphenated
-description: When to use  # Triggers activation
-license: MIT              # Optional
----
-```
-
-Body: Quick reference, workflow, tables. <100 lines.
-
-## Key Principles
-
-1. **Progressive Disclosure** - SKILL.md = index, references = details
-2. **Token Efficient** - Each file <100 lines
-3. **Practical** - Instructions for doing, not documentation
-4. **Standalone** - Can combine with other skills
-
-## Marketing Skill Examples
-
-| Skill | Purpose |
-|-------|---------|
-| copywriting | Conversion formulas, headlines, CTAs |
-| email | Sequences, templates, deliverability |
-| seo | Keywords, audits, pSEO |
-| brand | Voice, colors, logo usage |
-
-## Creation Workflow
-
-1. **Define scope** - What task(s)?
-2. **Identify patterns** - Reusable workflows?
-3. **Create SKILL.md** - Index + quick ref
-4. **Add references** - Detailed patterns
-5. **Add scripts** - If deterministic tasks
-6. **Test** - Use in real scenarios
-
-## References Best Practice
-
-- File per topic (<100 lines each)
-- Practical patterns, not theory
-- Include examples
-- Link related references
-
-## Scripts Best Practice
-
-- Node.js or Python (not bash)
-- Support `.env` hierarchy
-- Include tests
-- Handle errors gracefully
-
-## Connecting to Agents
-
-Add "Agent Integration" section to SKILL.md:
-```markdown
-## Agent Integration
-**Primary Agent:** {agent-name}
-**Related Skills:** {comma-separated}
-```

package/.opencode/skills/kit-builder/references/workflow-guide.md

@@ -1,113 +0,0 @@
-# Workflow Creation Guide
-
-Workflows = process definitions for multi-step orchestration.
-
-## Location
-
-`.opencode/workflows/{workflow-name}.md`
-
-## Purpose
-
-Define repeatable processes that:
-- Coordinate multiple agents
-- Define quality gates
-- Establish handoff points
-- Document decision trees
-
-## Structure
-
-```markdown
-# Workflow Name
-
-## Purpose
-What this workflow accomplishes.
-
-## Triggers
-When to use this workflow.
-
-## Agents Involved
-| Agent | Role |
-|-------|------|
-
-## Process
-### Phase 1: [Name]
-- Step 1
-- Step 2
-### Phase 2: [Name]
-...
-
-## Quality Gates
-- [ ] Checkpoint 1
-- [ ] Checkpoint 2
-
-## Outputs
-Expected deliverables.
-```
-
-## Marketing Workflow Examples
-
-| Workflow | Purpose |
-|----------|---------|
-| content-workflow | Content creation pipeline |
-| campaign-workflow | Campaign launch process |
-| seo-workflow | SEO optimization process |
-| sales-workflow | Sales enablement pipeline |
-
-## Workflow vs Command
-
-| Aspect | Workflow | Command |
-|--------|----------|---------|
-| Scope | Full process | Single action |
-| Invocation | Referenced | /command |
-| Detail | Deep | Concise |
-| Updates | Evolves | Stable |
-
-## Best Practices
-
-1. **Clear phases** - Break into logical steps
-2. **Agent assignment** - Who does what
-3. **Quality gates** - Validation checkpoints
-4. **Decision trees** - Handle branches
-5. **Outputs defined** - Expected deliverables
-
-## Integration Patterns
-
-### Workflow → Agent
-```markdown
-## Phase 1: Research
-**Agent:** researcher
-**Skills:** docs-seeker, web-search
-**Output:** Research report
-```
-
-### Workflow → Command
-```markdown
-## Quick Start
-Run `/write:blog [topic]` to begin.
-```
-
-## Quality Gate Template
-
-```markdown
-## Quality Gates
-### Before Phase 2
-- [ ] Research complete
-- [ ] Outline approved
-- [ ] Keywords validated
-
-### Before Publish
-- [ ] SEO check passed
-- [ ] Brand review done
-- [ ] Links verified
-```
-
-## Decision Tree Pattern
-
-```markdown
-## Routing
-Content type?
-├── Blog → content-workflow
-├── Email → email-workflow
-├── Social → social-workflow
-└── Landing page → content-workflow + design-workflow
-```