@macpaw/cctk 1.0.0-beta.1

package/templates/claude/skills/README.md

@@ -0,0 +1,112 @@
+# Skills
+Skills are folders of instructions, scripts, and resources that Claude loads dynamically to improve performance on specialized tasks. Skills teach Claude how to complete specific tasks in a repeatable way, whether that's creating documents with your company's brand guidelines, analyzing data using your organization's specific workflows, or automating personal tasks.
+
+For more information, check out:
+- [What are skills?](https://support.claude.com/en/articles/12512176-what-are-skills)
+- [Using skills in Claude](https://support.claude.com/en/articles/12512180-using-skills-in-claude)
+- [How to create custom skills](https://support.claude.com/en/articles/12512198-creating-custom-skills)
+- [Equipping agents for the real world with Agent Skills](https://anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills)
+
+# About This Repository
+
+This repository contains example skills that demonstrate what's possible with Claude's skills system. These examples range from creative applications (art, music, design) to technical tasks (testing web apps, MCP server generation) to enterprise workflows (communications, branding, etc.).
+
+Each skill is self-contained in its own directory with a `SKILL.md` file containing the instructions and metadata that Claude uses. Browse through these examples to get inspiration for your own skills or to understand different patterns and approaches.
+
+The example skills in this repo are open source (Apache 2.0).
+
+**Note:** These are reference examples for inspiration and learning. They showcase general-purpose capabilities rather than organization-specific workflows or sensitive content.
+
+## Disclaimer
+
+**These skills are provided for demonstration and educational purposes only.** While some of these capabilities may be available in Claude, the implementations and behaviors you receive from Claude may differ from what is shown in these examples. These examples are meant to illustrate patterns and possibilities. Always test skills thoroughly in your own environment before relying on them for critical tasks.
+
+# Installation
+
+Some skills require external dependencies (FFmpeg, ImageMagick, Node.js packages, Python packages). Use our automated installation scripts to set up all dependencies:
+
+## Automated Installation
+
+```bash
+npx @mwkt/cc-toolkit install
+```
+
+The CLI will:
+- Install system tools (FFmpeg, ImageMagick)
+- Install Node.js packages (rmbg-cli, pnpm, wrangler, repomix)
+- Create Python virtual environment
+- Install Python packages for skills that need them
+- Run npm install for skills with Node.js dependencies
+- Generate configuration files
+
+# Example Skills
+
+This repository includes a diverse collection of example skills demonstrating different capabilities:
+
+## Creative & Design
+- **algorithmic-art** - Create generative art using p5.js with seeded randomness, flow fields, and particle systems
+- **canvas-design** - Design beautiful visual art in .png and .pdf formats using design philosophies
+- **slack-gif-creator** - Create animated GIFs optimized for Slack's size constraints
+
+## Development & Technical
+- **artifacts-builder** - Build complex claude.ai HTML artifacts using React, Tailwind CSS, and shadcn/ui components
+- **mcp-server** - Guide for creating high-quality MCP servers to integrate external APIs and services
+- **webapp-testing** - Test local web applications using Playwright for UI verification and debugging
+
+## Enterprise & Communication
+- **brand-guidelines** - Apply Anthropic's official brand colors and typography to artifacts
+- **internal-comms** - Write internal communications like status reports, newsletters, and FAQs
+- **theme-factory** - Style artifacts with 10 pre-set professional themes or generate custom themes on-the-fly
+
+## Meta Skills
+- **skill-creator** - Guide for creating effective skills that extend Claude's capabilities
+- **template-skill** - A basic template to use as a starting point for new skills
+
+# Try in Claude Code, Claude.ai, and the API
+
+## Claude Code
+You can register this repository as a Claude Code Plugin marketplace by running the following command in Claude Code:
+```
+/plugin marketplace add anthropics/skills
+```
+
+After installing the plugin, you can use the skill by just mentioning it. For instance, you can ask Claude Code to do something like: "use the debugging skill to analyze this error"
+
+## Claude.ai
+
+These example skills are all already available to paid plans in Claude.ai. 
+
+To use any skill from this repository or upload custom skills, follow the instructions in [Using skills in Claude](https://support.claude.com/en/articles/12512180-using-skills-in-claude#h_a4222fa77b).
+
+## Claude API
+
+You can use Anthropic's pre-built skills, and upload custom skills, via the Claude API. See the [Skills API Quickstart](https://docs.claude.com/en/api/skills-guide#creating-a-skill) for more.
+
+# Creating a Basic Skill
+
+Skills are simple to create - just a folder with a `SKILL.md` file containing YAML frontmatter and instructions. You can use the **template-skill** in this repository as a starting point:
+
+```markdown
+---
+name: my-skill-name
+description: A clear description of what this skill does and when to use it
+---
+
+# My Skill Name
+
+[Add your instructions here that Claude will follow when this skill is active]
+
+## Examples
+- Example usage 1
+- Example usage 2
+
+## Guidelines
+- Guideline 1
+- Guideline 2
+```
+
+The frontmatter requires only two fields:
+- `name` - A unique identifier for your skill (lowercase, hyphens for spaces)
+- `description` - A complete description of what the skill does and when to use it
+
+The markdown content below contains the instructions, examples, and guidelines that Claude will follow. For more details, see [How to create custom skills](https://support.claude.com/en/articles/12512198-creating-custom-skills).

package/templates/claude/skills/ai-artist/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: ai-artist
+description: Write and optimize prompts for AI-generated outcomes across text and image models. Use when crafting prompts for LLMs (Claude, GPT, Gemini), image generators (Midjourney, DALL-E, Stable Diffusion, Imagen, Flux), or video generators (Veo, Runway). Covers prompt structure, style keywords, negative prompts, chain-of-thought, few-shot examples, iterative refinement, and domain-specific patterns for marketing, code, and creative writing.
+version: 1.0.0
+license: MIT
+---
+
+# AI Artist - Prompt Engineering
+
+Craft effective prompts for AI text and image generation models.
+
+## Core Principles
+
+1. **Clarity** - Be specific, avoid ambiguity
+2. **Context** - Set scene, role, constraints upfront
+3. **Structure** - Use consistent formatting (markdown, XML tags, delimiters)
+4. **Iteration** - Refine based on outputs, A/B test variations
+
+## Quick Patterns
+
+### LLM Prompts (Claude/GPT/Gemini)
+
+```
+[Role] You are a {expert type} specializing in {domain}.
+[Context] {Background information and constraints}
+[Task] {Specific action to perform}
+[Format] {Output structure - JSON, markdown, list, etc.}
+[Examples] {1-3 few-shot examples if needed}
+```
+
+### Image Generation (Midjourney/DALL-E/Stable Diffusion)
+
+```
+[Subject] {main subject with details}
+[Style] {artistic style, medium, artist reference}
+[Composition] {framing, angle, lighting}
+[Quality] {resolution modifiers, rendering quality}
+[Negative] {what to avoid - only if supported}
+```
+
+**Example**: `Portrait of a cyberpunk hacker, neon lighting, cinematic composition, detailed face, 8k, artstation quality --ar 16:9 --style raw`
+
+## References
+
+Load for detailed guidance:
+
+| Topic | File | Description |
+|-------|------|-------------|
+| LLM | `references/llm-prompting.md` | System prompts, few-shot, CoT, output formatting |
+| Image | `references/image-prompting.md` | Style keywords, model syntax, negative prompts |
+| Nano Banana | `references/nano-banana.md` | Gemini image prompting, narrative style, multi-image input |
+| Advanced | `references/advanced-techniques.md` | Meta-prompting, chaining, A/B testing |
+| Domain Index | `references/domain-patterns.md` | Universal pattern, links to domain files |
+| Marketing | `references/domain-marketing.md` | Headlines, product copy, emails, ads |
+| Code | `references/domain-code.md` | Functions, review, refactoring, debugging |
+| Writing | `references/domain-writing.md` | Stories, characters, dialogue, editing |
+| Data | `references/domain-data.md` | Extraction, analysis, comparison |
+
+## Model-Specific Tips
+
+| Model | Key Syntax |
+|-------|------------|
+| Midjourney | `--ar`, `--style`, `--chaos`, `--weird`, `--v 6.1` |
+| DALL-E 3 | Natural language, no parameters, HD quality option |
+| Stable Diffusion | Weighted tokens `(word:1.2)`, LoRA, negative prompt |
+| Flux | Natural prompts, style mixing, `--guidance` |
+| Imagen/Veo | Descriptive text, aspect ratio, style references |
+
+## Anti-Patterns
+
+- Vague instructions ("make it better")
+- Conflicting constraints
+- Missing context for domain tasks
+- Over-prompting with redundant details
+- Ignoring model-specific strengths/limits

package/templates/claude/skills/ai-artist/references/advanced-techniques.md

@@ -0,0 +1,184 @@
+# Advanced Prompt Engineering
+
+## Prompt Optimization
+
+### DSPy Framework
+Automatic prompt optimization through:
+1. Define task with input/output signatures
+2. Compile with optimizer (BootstrapFewShot, MIPRO)
+3. Model learns optimal prompting strategy
+4. Export optimized prompts for production
+
+### Meta-Prompting
+```
+You are a prompt engineer. Create 5 variations for [task]:
+1. Direct instruction approach
+2. Role-based approach
+3. Few-shot example approach
+4. Chain of thought approach
+5. Constraint-focused approach
+
+Evaluate each, select best.
+```
+
+### Self-Refinement Loop
+```
+Generate: [Initial response]
+Critique: "What's wrong? Score 1-10."
+Refine: "Fix issues, improve score."
+Repeat until score ≥ 8.
+```
+
+## Prompt Chaining
+
+### Sequential Chain
+```
+Chain 1: [Input] → Extract key points
+Chain 2: Key points → Create outline
+Chain 3: Outline → Write draft
+Chain 4: Draft → Edit and polish
+```
+
+### Parallel Chain
+Run independent subtasks simultaneously, merge results.
+
+### Conditional Chain
+```
+If [condition A]: Execute prompt variant 1
+If [condition B]: Execute prompt variant 2
+Else: Execute default prompt
+```
+
+### Loop Pattern
+```
+While not [success condition]:
+    Generate attempt
+    Evaluate against criteria
+    If pass: break
+    Else: refine with feedback
+```
+
+## Evaluation Methods
+
+### LLM-as-Judge
+```
+Rate this [output] on:
+1. Accuracy (1-10)
+2. Completeness (1-10)
+3. Clarity (1-10)
+4. Relevance (1-10)
+
+Provide reasoning for each score.
+Final: Pass/Fail threshold = 7 average.
+```
+
+### A/B Testing Protocol
+1. Single variable per test
+2. 20+ samples minimum
+3. Score on defined criteria
+4. Statistical significance check (p < 0.05)
+5. Document winner, roll out
+
+### Regression Testing
+- Maintain test set of critical examples
+- Run before deploying prompt changes
+- Compare scores to baseline
+- Block deployment if regression detected
+
+## Agent Prompting
+
+### Tool Use Design
+```
+You have access to these tools:
+- search(query): Search the web
+- calculate(expression): Math operations
+- code(language, code): Execute code
+
+To use: <tool_name>arguments</tool_name>
+Wait for result before continuing.
+```
+
+### Planning Prompt
+```
+Task: [Complex goal]
+
+Before acting:
+1. Break into subtasks
+2. Identify dependencies
+3. Plan execution order
+4. Note potential blockers
+
+Then execute step by step.
+```
+
+### Reflection Pattern
+```
+After each step:
+- What worked?
+- What didn't?
+- Adjust approach for next step.
+```
+
+## Parameter Tuning
+
+| Parameter | Low | High | Use Case |
+|-----------|-----|------|----------|
+| Temperature | 0.0-0.3 | 0.7-1.0 | Factual vs Creative |
+| Top-P | 0.8 | 0.95 | Focused vs Diverse |
+| Top-K | 10 | 100 | Conservative vs Exploratory |
+
+**Rule**: Tune temperature first. Only adjust top-p if needed. Never both at once.
+
+## Safety Patterns
+
+### Output Filtering
+```
+Before responding, check:
+- No PII exposure
+- No harmful content
+- No policy violations
+- Aligned with guidelines
+
+If any fail: "I can't help with that."
+```
+
+### Jailbreak Prevention
+- Clear system boundaries upfront
+- Repeat constraints at end
+- "Ignore previous" pattern detection
+- Role-lock: "You are ONLY [role], never anything else"
+
+### Confidence Calibration
+```
+For each claim, provide:
+- Confidence: High/Medium/Low
+- Source: [citation if available]
+- Caveat: [limitations]
+```
+
+## Production Patterns
+
+### Version Control
+- Git for prompt files
+- Semantic versioning (1.0.0, 1.1.0)
+- Changelog per version
+- Rollback capability
+
+### Caching
+- Cache common queries
+- TTL based on content freshness
+- Invalidate on prompt update
+
+### Fallbacks
+```
+Try: Primary prompt
+If fail: Simplified fallback prompt
+If still fail: Human escalation
+Log all failures for analysis.
+```
+
+### Cost Optimization
+- Shorter prompts = fewer tokens
+- Remove redundant examples
+- Use smaller model for simple tasks
+- Batch similar requests

package/templates/claude/skills/ai-artist/references/domain-code.md

@@ -0,0 +1,66 @@
+# Code Generation Patterns
+
+## Function Implementation
+```
+Write a [language] function:
+- Input: [params with types]
+- Output: [return type]
+- Behavior: [logic]
+
+Requirements:
+- Edge cases: [list]
+- Error handling: [approach]
+- Performance: O([complexity])
+```
+
+## Code Review
+```
+Review for:
+1. Bugs/logic errors
+2. Security vulnerabilities
+3. Performance issues
+4. Style violations
+5. Missing edge cases
+
+Format: Issue, line number, severity, fix.
+```
+
+## Refactoring
+```
+Refactor to:
+- [Improvement goal]
+- Maintain backward compatibility
+- Keep public API
+- Add comments for complex logic
+Show before/after.
+```
+
+## Debugging
+```
+<error>[Error message/behavior]</error>
+<code>[Relevant code]</code>
+<context>[When it occurs]</context>
+
+Analyze:
+1. Root cause
+2. Why it happens
+3. Fix with explanation
+4. Prevention strategy
+```
+
+## Test Generation
+```
+Generate tests for [function/class]:
+- Framework: [jest/pytest/etc]
+- Coverage: happy path, edge cases, errors
+- Include: setup, assertion, cleanup
+- Mock: [external dependencies]
+```
+
+## Documentation
+```
+Document this [function/class/API]:
+- Format: [JSDoc/docstring/OpenAPI]
+- Include: description, params, returns, examples
+- Note: edge cases, errors, deprecations
+```

package/templates/claude/skills/ai-artist/references/domain-data.md

@@ -0,0 +1,72 @@
+# Data & Analysis Patterns
+
+## Structured Extraction
+```
+Extract from text:
+<text>[content]</text>
+
+Return JSON:
+{
+  "field1": "value or null",
+  "field2": ["array"]
+}
+
+Rules:
+- Exact matches only
+- Confidence score if uncertain
+- null for missing
+```
+
+## Document Analysis
+```
+Analyze [document type]:
+1. Summary (2-3 sentences)
+2. Key entities (people, orgs, dates)
+3. Main topics (ranked)
+4. Sentiment: positive/neutral/negative
+5. Action items
+```
+
+## Comparison
+```
+Compare [A] and [B]:
+| Criterion | A | B |
+|-----------|---|---|
+| [Factor 1] | | |
+| [Factor 2] | | |
+
+Recommendation: [choice] for [use case]
+```
+
+## Problem Solving
+```
+Problem: [description]
+
+Analyze:
+1. Root cause (5 whys)
+2. Contributing factors
+3. Options (pros/cons)
+4. Recommendation
+5. Implementation steps
+6. Risk mitigation
+```
+
+## Data Transformation
+```
+Transform data:
+- Input format: [CSV/JSON/etc]
+- Output format: [target]
+- Rules: [mapping logic]
+- Validation: [constraints]
+
+Handle: missing values, type mismatches.
+```
+
+## Summarization
+```
+Summarize [content]:
+- Length: [sentences/words]
+- Focus: [key themes]
+- Audience: [technical/general]
+- Preserve: [critical details]
+```

package/templates/claude/skills/ai-artist/references/domain-marketing.md

@@ -0,0 +1,66 @@
+# Marketing Copy Patterns
+
+## Headlines
+```
+Write 5 headline variations for [product].
+Frameworks:
+1. How to [benefit]
+2. [Number] ways to [solve problem]
+3. The secret to [outcome]
+4. Why [audience] love [product]
+5. [Timeframe] to [transformation]
+```
+
+## Product Descriptions
+```
+<product>[Name, features]</product>
+<audience>[Demographics, pain points]</audience>
+
+Write description that:
+- Opens with benefit (not feature)
+- Addresses [main objection]
+- Social proof placeholder
+- Clear CTA
+- Tone: [brand voice]
+- Length: [word count]
+```
+
+## Email Subject Lines
+```
+Generate 10 subject lines for [campaign].
+Mix approaches:
+- Curiosity gap
+- Urgency/scarcity
+- Personalization
+- Question format
+- Number/list
+Under 50 chars. Test 2-3 with emojis.
+```
+
+## Ad Copy
+```
+Platform: [Google/Meta/LinkedIn]
+Objective: [awareness/conversion]
+Character limit: [limit]
+
+Create [N] variations with:
+- Hook (first 5 words critical)
+- Value proposition
+- Social proof element
+- CTA matching platform norms
+```
+
+## Landing Pages
+```
+<offer>[Product/service]</offer>
+<goal>[signup/purchase/download]</goal>
+
+Write sections:
+1. Hero headline + subhead
+2. Problem agitation
+3. Solution introduction
+4. 3-5 benefit bullets
+5. Social proof
+6. CTA with urgency
+7. FAQ (3 objections)
+```

package/templates/claude/skills/ai-artist/references/domain-patterns.md

@@ -0,0 +1,33 @@
+# Domain-Specific Prompt Patterns
+
+Quick reference index. Load specific domain file for detailed patterns.
+
+## Domains
+
+| Domain | File | Use Cases |
+|--------|------|-----------|
+| Marketing | `domain-marketing.md` | Headlines, product copy, emails, ads |
+| Code | `domain-code.md` | Functions, review, refactoring, debugging |
+| Writing | `domain-writing.md` | Stories, characters, dialogue, editing |
+| Data | `domain-data.md` | Extraction, analysis, comparison, reasoning |
+
+## Universal Pattern
+
+All domain prompts follow:
+```
+<context>
+[Domain-specific background]
+</context>
+
+<task>
+[Specific action]
+</task>
+
+<constraints>
+[Quality criteria, format, length, tone]
+</constraints>
+
+<output>
+[Expected structure]
+</output>
+```

package/templates/claude/skills/ai-artist/references/domain-writing.md

@@ -0,0 +1,68 @@
+# Creative Writing Patterns
+
+## Story Outline
+```
+Create [length] story outline:
+- Genre: [genre]
+- Protagonist: [brief]
+- Conflict: [type]
+- Setting: [time/place]
+
+Structure:
+1. Hook/Opening
+2. Inciting incident
+3. Rising action (3 beats)
+4. Climax
+5. Resolution
+```
+
+## Character Voice
+```
+Write as [character]:
+- Background: [history]
+- Speech: [patterns, vocab]
+- Emotion: [current state]
+- Goal: [scene objective]
+
+Maintain voice consistency.
+```
+
+## Dialogue
+```
+Write dialogue between [A] and [B]:
+- Scene: [context]
+- Tension: [conflict source]
+- Subtext: [what's unsaid]
+
+Each character distinct voice. Show don't tell.
+```
+
+## Scene Description
+```
+Describe [scene]:
+- POV: [character/omniscient]
+- Focus: [sensory details]
+- Mood: [atmosphere]
+- Pacing: [fast/slow/measured]
+
+Use active verbs, concrete details.
+```
+
+## Editing Pass
+```
+Edit this [content type]:
+Focus: [clarity/flow/voice/grammar]
+Preserve: [author's style]
+Flag: [major issues only]
+
+Provide tracked changes with rationale.
+```
+
+## Genre Adaptation
+```
+Rewrite [content] as [genre]:
+- Keep: core plot/message
+- Add: genre conventions
+- Tone: [genre-appropriate]
+- Tropes: [use/subvert specific tropes]
+```