@macpaw/cctk 1.0.0-beta.1

package/templates/claude/skills/registry.json

@@ -0,0 +1,258 @@
+{
+  "name": "skills",
+  "version": "1.0.0",
+  "items": [
+    {
+      "name": "ai-artist",
+      "title": "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.",
+      "files": ["skills/ai-artist/"],
+      "dependencies": {},
+      "meta": { "runtime": "node", "externalDeps": [] }
+    },
+    {
+      "name": "backend-development",
+      "title": "Backend Development",
+      "description": "Build robust backend systems with modern technologies (Node.js, Python, Go, Rust), frameworks (NestJS, FastAPI, Django), databases (PostgreSQL, MongoDB, Redis), APIs (REST, GraphQL, gRPC), authentication (OAuth 2.1, JWT), testing strategies, security best practices (OWASP Top 10), performance optimization, scalability patterns (microservices, caching, sharding), DevOps practices (Docker, Kubernetes, CI/CD), and monitoring. Use when designing APIs, implementing authentication, optimizing database queries, setting up CI/CD pipelines, handling security vulnerabilities, building microservices, or developing production-ready backend systems.",
+      "files": ["skills/backend-development/"],
+      "dependencies": {},
+      "meta": { "runtime": "node", "externalDeps": [] }
+    },
+    {
+      "name": "better-auth",
+      "title": "Better Auth",
+      "description": "Implement authentication and authorization with Better Auth - a framework-agnostic TypeScript authentication framework. Features include email/password authentication with verification, OAuth providers (Google, GitHub, Discord, etc.), two-factor authentication (TOTP, SMS), passkeys/WebAuthn support, session management, role-based access control (RBAC), rate limiting, and database adapters. Use when adding authentication to applications, implementing OAuth flows, setting up 2FA/MFA, managing user sessions, configuring authorization rules, or building secure authentication systems for web applications.",
+      "files": ["skills/better-auth/"],
+      "dependencies": {},
+      "meta": { "runtime": "python", "externalDeps": [] }
+    },
+    {
+      "name": "chrome-devtools",
+      "title": "Chrome DevTools",
+      "description": "Browser automation, debugging, and performance analysis using Puppeteer CLI scripts. Use for automating browsers, taking screenshots, analyzing performance, monitoring network traffic, web scraping, form automation, and JavaScript debugging.",
+      "files": ["skills/chrome-devtools/"],
+      "dependencies": {},
+      "meta": { "runtime": "node", "externalDeps": [], "postInstall": "npm install" }
+    },
+    {
+      "name": "claude-code",
+      "title": "Claude Code",
+      "description": "Activate when users ask about Claude Code installation, slash commands (/plan, /fix, /test, /docs, /design, /git), creating/managing Agent Skills, configuring MCP servers, setting up hooks/plugins, IDE integration (VS Code, JetBrains), CI/CD workflows, enterprise deployment (SSO, RBAC, sandboxing), troubleshooting authentication/performance issues, or advanced features (extended thinking, caching, checkpointing).",
+      "files": ["skills/claude-code/"],
+      "dependencies": {},
+      "meta": { "runtime": "node", "externalDeps": [] }
+    },
+    {
+      "name": "code-review",
+      "title": "Code Review",
+      "description": "Use when receiving code review feedback (especially if unclear or technically questionable), when completing tasks or major features requiring review before proceeding, or before making any completion/success claims. Covers three practices - receiving feedback with technical rigor over performative agreement, requesting reviews via code-reviewer subagent, and verification gates requiring evidence before any status claims. Essential for subagent-driven development, pull requests, and preventing false completion claims.",
+      "files": ["skills/code-review/"],
+      "dependencies": {},
+      "meta": { "runtime": "node", "externalDeps": [] }
+    },
+    {
+      "name": "context-engineering",
+      "title": "Context Engineering",
+      "description": "Master context engineering for AI agent systems. Use when designing agent architectures, debugging context failures, optimizing token usage, implementing memory systems, building multi-agent coordination, evaluating agent performance, or developing LLM-powered pipelines. Covers context fundamentals, degradation patterns, optimization techniques (compaction, masking, caching), compression strategies, memory architectures, multi-agent patterns, LLM-as-Judge evaluation, tool design, and project development.",
+      "files": ["skills/context-engineering/"],
+      "dependencies": {},
+      "meta": { "runtime": "python", "externalDeps": [] }
+    },
+    {
+      "name": "databases",
+      "title": "Databases",
+      "description": "Work with MongoDB (document database, BSON documents, aggregation pipelines, Atlas cloud) and PostgreSQL (relational database, SQL queries, psql CLI, pgAdmin). Use when designing database schemas, writing queries and aggregations, optimizing indexes for performance, performing database migrations, configuring replication and sharding, implementing backup and restore strategies, managing database users and permissions, analyzing query performance, or administering production databases.",
+      "files": ["skills/databases/"],
+      "dependencies": {},
+      "meta": {
+        "runtime": "python",
+        "externalDeps": [
+          { "name": "PostgreSQL Client", "type": "brew", "command": "psql", "install": "brew install libpq" },
+          { "name": "MongoDB Shell", "type": "brew", "command": "mongosh", "install": "brew install mongosh" }
+        ]
+      }
+    },
+    {
+      "name": "debugging",
+      "title": "Debugging",
+      "description": "Systematic debugging framework ensuring root cause investigation before fixes. Includes four-phase debugging process, backward call stack tracing, multi-layer validation, and verification protocols. Use when encountering bugs, test failures, unexpected behavior, performance issues, or before claiming work complete. Prevents random fixes, masks over symptoms, and false completion claims.",
+      "files": ["skills/debugging/"],
+      "dependencies": {},
+      "meta": { "runtime": "node", "externalDeps": [] }
+    },
+    {
+      "name": "devops",
+      "title": "DevOps",
+      "description": "Deploy and manage cloud infrastructure on Cloudflare (Workers, R2, D1, KV, Pages, Durable Objects, Browser Rendering), Docker containers, and Google Cloud Platform (Compute Engine, GKE, Cloud Run, App Engine, Cloud Storage). Use when deploying serverless functions to the edge, configuring edge computing solutions, managing Docker containers and images, setting up CI/CD pipelines, optimizing cloud infrastructure costs, implementing global caching strategies, working with cloud databases, or building cloud-native applications.",
+      "files": ["skills/devops/"],
+      "dependencies": {},
+      "meta": {
+        "runtime": "python",
+        "externalDeps": [
+          { "name": "Wrangler", "type": "npm", "command": "wrangler", "install": "npm install -g wrangler", "optional": true },
+          { "name": "Docker", "type": "manual", "command": "docker", "install": "Install Docker Desktop from docker.com", "optional": true },
+          { "name": "Google Cloud SDK", "type": "manual", "command": "gcloud", "install": "Install from cloud.google.com/sdk", "optional": true }
+        ]
+      }
+    },
+    {
+      "name": "docs-seeker",
+      "title": "Docs Seeker",
+      "description": "Search technical documentation using executable scripts to detect query type, fetch from llms.txt sources (context7.com), and analyze results. Use when user needs: (1) Topic-specific documentation (features/components/concepts), (2) Library/framework documentation, (3) GitHub repository analysis, (4) Documentation discovery with automated agent distribution strategy",
+      "files": ["skills/docs-seeker/"],
+      "dependencies": {},
+      "meta": { "runtime": "node", "externalDeps": [] }
+    },
+    {
+      "name": "frontend-design",
+      "title": "Frontend Design",
+      "description": "Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications, OR when they provide screenshots/images/designs to replicate or draw inspiration from. Generates creative, polished code that avoids generic AI aesthetics.",
+      "files": ["skills/frontend-design/"],
+      "dependencies": { "skills": ["media-processing"] },
+      "meta": { "runtime": "node", "externalDeps": [] }
+    },
+    {
+      "name": "frontend-development",
+      "title": "Frontend Development",
+      "description": "Frontend development guidelines for React/TypeScript applications. Modern patterns including Suspense, lazy loading, useSuspenseQuery, file organization with features directory, MUI v7 styling, TanStack Router, performance optimization, and TypeScript best practices. Use when creating components, pages, features, fetching data, styling, routing, or working with frontend code.",
+      "files": ["skills/frontend-development/"],
+      "dependencies": {},
+      "meta": { "runtime": "node", "externalDeps": [] }
+    },
+    {
+      "name": "markdown-novel-viewer",
+      "title": "Markdown Novel Viewer",
+      "description": "Background HTTP server rendering markdown files with calm, book-like reading experience. Universal viewer for markdown files and directories with novel-reader UI, serif fonts, warm theme, Mermaid.js diagrams, and plan navigation.",
+      "files": ["skills/markdown-novel-viewer/"],
+      "dependencies": {},
+      "meta": { "runtime": "node", "externalDeps": [], "postInstall": "npm install" }
+    },
+    {
+      "name": "mcp-builder",
+      "title": "MCP Builder",
+      "description": "Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through standardized protocols. Supports Python (FastMCP) and Node/TypeScript SDK implementations, evaluation harness, and quality checklists.",
+      "files": ["skills/mcp-builder/"],
+      "dependencies": {},
+      "meta": {
+        "runtime": "python",
+        "externalDeps": [
+          { "name": "Anthropic SDK", "type": "pip", "command": "pip3 show anthropic", "install": "pip3 install anthropic" },
+          { "name": "MCP SDK", "type": "pip", "command": "pip3 show mcp", "install": "pip3 install mcp" }
+        ]
+      }
+    },
+    {
+      "name": "mcp-management",
+      "title": "MCP Management",
+      "description": "Manage Model Context Protocol (MCP) servers - discover, analyze, and execute tools/prompts/resources from configured MCP servers. Use when working with MCP integrations, need to discover available MCP capabilities, filter MCP tools for specific tasks, execute MCP tools programmatically, access MCP prompts/resources, or implement MCP client functionality. Supports intelligent tool selection, multi-server management, and context-efficient capability discovery.",
+      "files": ["skills/mcp-management/"],
+      "dependencies": {},
+      "meta": { "runtime": "node", "externalDeps": [], "postInstall": "npm install" }
+    },
+    {
+      "name": "media-processing",
+      "title": "Media Processing",
+      "description": "Process multimedia files with FFmpeg (video/audio encoding, conversion, streaming, filtering, hardware acceleration), ImageMagick (image manipulation, format conversion, batch processing), and RMBG (AI-powered background removal). Use for video encoding, audio extraction, image resize/effects, background removal, batch processing, HLS/DASH streaming, and GIF creation.",
+      "files": ["skills/media-processing/"],
+      "dependencies": {},
+      "meta": {
+        "runtime": "shell",
+        "externalDeps": [
+          { "name": "FFmpeg", "type": "brew", "command": "ffmpeg", "install": "brew install ffmpeg" },
+          { "name": "ImageMagick", "type": "brew", "command": "magick", "install": "brew install imagemagick" },
+          { "name": "RMBG CLI", "type": "npm", "command": "rmbg", "install": "npm install -g rmbg-cli" }
+        ]
+      }
+    },
+    {
+      "name": "mermaidjs-v11",
+      "title": "Mermaid.js v11",
+      "description": "Create diagrams and visualizations using Mermaid.js v11 syntax. Use when generating flowcharts, sequence diagrams, class diagrams, state diagrams, ER diagrams, Gantt charts, user journeys, timelines, architecture diagrams, or any of 24+ diagram types. Supports JavaScript API integration, CLI rendering to SVG/PNG/PDF, theming, configuration, and accessibility features. Essential for documentation, technical diagrams, project planning, system architecture, and visual communication.",
+      "files": ["skills/mermaidjs-v11/"],
+      "dependencies": {},
+      "meta": {
+        "runtime": "node",
+        "externalDeps": [
+          { "name": "Mermaid CLI", "type": "npm", "command": "mmdc", "install": "npm install -g @mermaid-js/mermaid-cli", "optional": true }
+        ]
+      }
+    },
+    {
+      "name": "planning",
+      "title": "Planning",
+      "description": "Use when you need to plan technical solutions that are scalable, secure, and maintainable.",
+      "files": ["skills/planning/"],
+      "dependencies": { "scripts": ["plan-manager"] },
+      "meta": { "runtime": "node", "externalDeps": [] }
+    },
+    {
+      "name": "plans-kanban",
+      "title": "Plans Kanban",
+      "description": "Plans dashboard server with progress tracking and timeline visualization. Visual dashboard for viewing plan directories with progress tracking per plan, timeline/Gantt visualization, phase status indicators, and activity heatmap.",
+      "files": ["skills/plans-kanban/"],
+      "dependencies": {},
+      "meta": { "runtime": "node", "externalDeps": [], "postInstall": "npm install" }
+    },
+    {
+      "name": "problem-solving",
+      "title": "Problem-Solving Techniques",
+      "description": "Apply systematic problem-solving techniques for complexity spirals (simplification cascades), innovation blocks (collision-zone thinking), recurring patterns (meta-pattern recognition), assumption constraints (inversion exercise), scale uncertainty (scale game), and dispatch when stuck. Techniques derived from Microsoft Amplifier project patterns adapted for immediate application.",
+      "files": ["skills/problem-solving/"],
+      "dependencies": {},
+      "meta": { "runtime": "node", "externalDeps": [] }
+    },
+    {
+      "name": "repomix",
+      "title": "Repomix",
+      "description": "Package entire code repositories into single AI-friendly files using Repomix. Capabilities include pack codebases with customizable include/exclude patterns, generate multiple output formats (XML, Markdown, plain text), preserve file structure and context, optimize for AI consumption with token counting, filter by file types and directories, add custom headers and summaries. Use when packaging codebases for AI analysis, creating repository snapshots for LLM context, analyzing third-party libraries, preparing for security audits, generating documentation context, or evaluating unfamiliar codebases.",
+      "files": ["skills/repomix/"],
+      "dependencies": {},
+      "meta": {
+        "runtime": "python",
+        "externalDeps": [
+          { "name": "Repomix", "type": "npm", "command": "repomix", "install": "npm install -g repomix" }
+        ]
+      }
+    },
+    {
+      "name": "research",
+      "title": "Research",
+      "description": "Use when you need to research, analyze, and plan technical solutions that are scalable, secure, and maintainable.",
+      "files": ["skills/research/"],
+      "dependencies": { "skills": ["docs-seeker"] },
+      "meta": { "runtime": "node", "externalDeps": [] }
+    },
+    {
+      "name": "sequential-thinking",
+      "title": "Sequential Thinking",
+      "description": "Apply structured, reflective problem-solving for complex tasks requiring multi-step analysis, revision capability, and hypothesis verification. Use for complex problem decomposition, adaptive planning, analysis needing course correction, problems with unclear scope, multi-step solutions, and hypothesis-driven work.",
+      "files": ["skills/sequential-thinking/"],
+      "dependencies": {},
+      "meta": { "runtime": "node", "externalDeps": [] }
+    },
+    {
+      "name": "skill-creator",
+      "title": "Skill Creator",
+      "description": "Guide for creating effective skills, adding skill references, skill scripts or optimizing existing skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, frameworks, libraries or plugins usage, or API and tool integrations.",
+      "files": ["skills/skill-creator/"],
+      "dependencies": {},
+      "meta": { "runtime": "python", "externalDeps": [] }
+    },
+    {
+      "name": "template-skill",
+      "title": "Template Skill",
+      "description": "Replace with description of the skill and when Claude should use it.",
+      "files": ["skills/template-skill/"],
+      "dependencies": {},
+      "meta": { "runtime": "node", "externalDeps": [] }
+    },
+    {
+      "name": "web-frameworks",
+      "title": "Web Frameworks",
+      "description": "Build modern full-stack web applications with Next.js (App Router, Server Components, RSC, PPR, SSR, SSG, ISR), Turborepo (monorepo management, task pipelines, remote caching, parallel execution), and RemixIcon (3100+ SVG icons in outlined/filled styles). Use when creating React applications, implementing server-side rendering, setting up monorepos with multiple packages, optimizing build performance and caching strategies, adding icon libraries, managing shared dependencies, or working with TypeScript full-stack projects.",
+      "files": ["skills/web-frameworks/"],
+      "dependencies": {},
+      "meta": { "runtime": "python", "externalDeps": [] }
+    }
+  ]
+}

package/templates/claude/skills/repomix/SKILL.md

@@ -0,0 +1,247 @@
+---
+name: repomix
+description: Package entire code repositories into single AI-friendly files using Repomix. Capabilities include pack codebases with customizable include/exclude patterns, generate multiple output formats (XML, Markdown, plain text), preserve file structure and context, optimize for AI consumption with token counting, filter by file types and directories, add custom headers and summaries. Use when packaging codebases for AI analysis, creating repository snapshots for LLM context, analyzing third-party libraries, preparing for security audits, generating documentation context, or evaluating unfamiliar codebases.
+---
+
+# Repomix Skill
+
+Repomix packs entire repositories into single, AI-friendly files. Perfect for feeding codebases to LLMs like Claude, ChatGPT, and Gemini.
+
+## When to Use
+
+Use when:
+- Packaging codebases for AI analysis
+- Creating repository snapshots for LLM context
+- Analyzing third-party libraries
+- Preparing for security audits
+- Generating documentation context
+- Investigating bugs across large codebases
+- Creating AI-friendly code representations
+
+## Quick Start
+
+### Check Installation
+```bash
+repomix --version
+```
+
+### Install
+```bash
+# npm
+npm install -g repomix
+
+# Homebrew (macOS/Linux)
+brew install repomix
+```
+
+### Basic Usage
+```bash
+# Package current directory (generates repomix-output.xml)
+repomix
+
+# Specify output format
+repomix --style markdown
+repomix --style json
+
+# Package remote repository
+npx repomix --remote owner/repo
+
+# Custom output with filters
+repomix --include "src/**/*.ts" --remove-comments -o output.md
+```
+
+## Core Capabilities
+
+### Repository Packaging
+- AI-optimized formatting with clear separators
+- Multiple output formats: XML, Markdown, JSON, Plain text
+- Git-aware processing (respects .gitignore)
+- Token counting for LLM context management
+- Security checks for sensitive information
+
+### Remote Repository Support
+Process remote repositories without cloning:
+```bash
+# Shorthand
+npx repomix --remote yamadashy/repomix
+
+# Full URL
+npx repomix --remote https://github.com/owner/repo
+
+# Specific commit
+npx repomix --remote https://github.com/owner/repo/commit/hash
+```
+
+### Comment Removal
+Strip comments from supported languages (HTML, CSS, JavaScript, TypeScript, Vue, Svelte, Python, PHP, Ruby, C, C#, Java, Go, Rust, Swift, Kotlin, Dart, Shell, YAML):
+```bash
+repomix --remove-comments
+```
+
+## Common Use Cases
+
+### Code Review Preparation
+```bash
+# Package feature branch for AI review
+repomix --include "src/**/*.ts" --remove-comments -o review.md --style markdown
+```
+
+### Security Audit
+```bash
+# Package third-party library
+npx repomix --remote vendor/library --style xml -o audit.xml
+```
+
+### Documentation Generation
+```bash
+# Package with docs and code
+repomix --include "src/**,docs/**,*.md" --style markdown -o context.md
+```
+
+### Bug Investigation
+```bash
+# Package specific modules
+repomix --include "src/auth/**,src/api/**" -o debug-context.xml
+```
+
+### Implementation Planning
+```bash
+# Full codebase context
+repomix --remove-comments --copy
+```
+
+## Command Line Reference
+
+### File Selection
+```bash
+# Include specific patterns
+repomix --include "src/**/*.ts,*.md"
+
+# Ignore additional patterns
+repomix -i "tests/**,*.test.js"
+
+# Disable .gitignore rules
+repomix --no-gitignore
+```
+
+### Output Options
+```bash
+# Output format
+repomix --style markdown  # or xml, json, plain
+
+# Output file path
+repomix -o output.md
+
+# Remove comments
+repomix --remove-comments
+
+# Copy to clipboard
+repomix --copy
+```
+
+### Configuration
+```bash
+# Use custom config file
+repomix -c custom-config.json
+
+# Initialize new config
+repomix --init  # creates repomix.config.json
+```
+
+## Token Management
+
+Repomix automatically counts tokens for individual files, total repository, and per-format output.
+
+Typical LLM context limits:
+- Claude Sonnet 4.5: ~200K tokens
+- GPT-4: ~128K tokens
+- GPT-3.5: ~16K tokens
+
+### Token Count Optimization
+Understanding your codebase's token distribution is crucial for optimizing AI interactions. Use the --token-count-tree option to visualize token usage across your project:
+
+```bash
+repomix --token-count-tree
+```
+This displays a hierarchical view of your codebase with token counts:
+
+```
+🔢 Token Count Tree:
+────────────────────
+└── src/ (70,925 tokens)
+    ├── cli/ (12,714 tokens)
+    │   ├── actions/ (7,546 tokens)
+    │   └── reporters/ (990 tokens)
+    └── core/ (41,600 tokens)
+        ├── file/ (10,098 tokens)
+        └── output/ (5,808 tokens)
+```
+You can also set a minimum token threshold to focus on larger files:
+
+```bash
+repomix --token-count-tree 1000  # Only show files/directories with 1000+ tokens
+```
+
+This helps you:
+
+- Identify token-heavy files that might exceed AI context limits
+- Optimize file selection using --include and --ignore patterns
+- Plan compression strategies by targeting the largest contributors
+- Balance content vs. context when preparing code for AI analysis
+
+## Security Considerations
+
+Repomix uses Secretlint to detect sensitive data (API keys, passwords, credentials, private keys, AWS secrets).
+
+Best practices:
+1. Always review output before sharing
+2. Use `.repomixignore` for sensitive files
+3. Enable security checks for unknown codebases
+4. Avoid packaging `.env` files
+5. Check for hardcoded credentials
+
+Disable security checks if needed:
+```bash
+repomix --no-security-check
+```
+
+## Implementation Workflow
+
+When user requests repository packaging:
+
+1. **Assess Requirements**
+   - Identify target repository (local/remote)
+   - Determine output format needed
+   - Check for sensitive data concerns
+
+2. **Configure Filters**
+   - Set include patterns for relevant files
+   - Add ignore patterns for unnecessary files
+   - Enable/disable comment removal
+
+3. **Execute Packaging**
+   - Run repomix with appropriate options
+   - Monitor token counts
+   - Verify security checks
+
+4. **Validate Output**
+   - Review generated file
+   - Confirm no sensitive data
+   - Check token limits for target LLM
+
+5. **Deliver Context**
+   - Provide packaged file to user
+   - Include token count summary
+   - Note any warnings or issues
+
+## Reference Documentation
+
+For detailed information, see:
+- [Configuration Reference](./references/configuration.md) - Config files, include/exclude patterns, output formats, advanced options
+- [Usage Patterns](./references/usage-patterns.md) - AI analysis workflows, security audit preparation, documentation generation, library evaluation
+
+## Additional Resources
+
+- GitHub: https://github.com/yamadashy/repomix
+- Documentation: https://repomix.com/guide/
+- MCP Server: Available for AI assistant integration