clikit-plugin 0.2.44 → 0.2.46

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (177) hide show
  1. package/AGENTS.md +69 -3
  2. package/README.md +128 -92
  3. package/command/commit.md +1 -1
  4. package/command/create.md +65 -8
  5. package/command/debug.md +1 -1
  6. package/command/design.md +183 -43
  7. package/command/handoff.md +1 -1
  8. package/command/import-plan.md +2 -2
  9. package/command/init.md +1 -1
  10. package/command/issue.md +3 -4
  11. package/command/pr.md +1 -1
  12. package/command/research.md +5 -7
  13. package/command/resume.md +1 -1
  14. package/command/ship.md +29 -32
  15. package/command/start.md +38 -27
  16. package/command/{status-beads.md → status.md} +2 -3
  17. package/command/verify.md +132 -48
  18. package/dist/.tsbuildinfo +1 -1
  19. package/dist/agents/index.d.ts +0 -0
  20. package/dist/agents/index.d.ts.map +0 -0
  21. package/dist/beads-context.test.d.ts +2 -0
  22. package/dist/beads-context.test.d.ts.map +1 -0
  23. package/dist/cli.d.ts +0 -0
  24. package/dist/cli.d.ts.map +0 -0
  25. package/dist/cli.js +5 -0
  26. package/dist/cli.test.d.ts +0 -0
  27. package/dist/cli.test.d.ts.map +0 -0
  28. package/dist/clikit.schema.json +32 -11
  29. package/dist/clilog.test.d.ts +0 -0
  30. package/dist/clilog.test.d.ts.map +0 -0
  31. package/dist/commands/index.d.ts +0 -0
  32. package/dist/commands/index.d.ts.map +0 -0
  33. package/dist/config.d.ts +15 -7
  34. package/dist/config.d.ts.map +1 -1
  35. package/dist/config.test.d.ts +0 -0
  36. package/dist/config.test.d.ts.map +0 -0
  37. package/dist/hooks/beads-context.d.ts +2 -0
  38. package/dist/hooks/beads-context.d.ts.map +1 -1
  39. package/dist/hooks/empty-message-sanitizer.d.ts +0 -0
  40. package/dist/hooks/empty-message-sanitizer.d.ts.map +0 -0
  41. package/dist/hooks/error-logger.d.ts +0 -0
  42. package/dist/hooks/error-logger.d.ts.map +0 -0
  43. package/dist/hooks/git-guard.d.ts +0 -0
  44. package/dist/hooks/git-guard.d.ts.map +0 -0
  45. package/dist/hooks/index.d.ts +0 -2
  46. package/dist/hooks/index.d.ts.map +1 -1
  47. package/dist/hooks/memory-digest.d.ts +1 -0
  48. package/dist/hooks/memory-digest.d.ts.map +1 -1
  49. package/dist/hooks/security-check.d.ts +0 -0
  50. package/dist/hooks/security-check.d.ts.map +0 -0
  51. package/dist/hooks/subagent-question-blocker.d.ts +0 -0
  52. package/dist/hooks/subagent-question-blocker.d.ts.map +0 -0
  53. package/dist/hooks/todo-beads-sync.d.ts +1 -0
  54. package/dist/hooks/todo-beads-sync.d.ts.map +1 -1
  55. package/dist/hooks/todo-enforcer.d.ts +1 -1
  56. package/dist/hooks/todo-enforcer.d.ts.map +1 -1
  57. package/dist/hooks/truncator.d.ts +0 -0
  58. package/dist/hooks/truncator.d.ts.map +0 -0
  59. package/dist/index.d.ts +0 -0
  60. package/dist/index.d.ts.map +1 -1
  61. package/dist/index.js +250 -576
  62. package/dist/skills/index.d.ts +0 -0
  63. package/dist/skills/index.d.ts.map +0 -0
  64. package/dist/tools/cass-memory.d.ts +0 -0
  65. package/dist/tools/cass-memory.d.ts.map +0 -0
  66. package/dist/tools/context-summary.d.ts +0 -0
  67. package/dist/tools/context-summary.d.ts.map +0 -0
  68. package/dist/tools/index.d.ts +0 -3
  69. package/dist/tools/index.d.ts.map +1 -1
  70. package/dist/tools/memory-db.d.ts +0 -0
  71. package/dist/tools/memory-db.d.ts.map +0 -0
  72. package/dist/tools/memory.d.ts +0 -0
  73. package/dist/tools/memory.d.ts.map +0 -0
  74. package/dist/tools/observation.d.ts +0 -0
  75. package/dist/tools/observation.d.ts.map +0 -0
  76. package/dist/types.d.ts +0 -0
  77. package/dist/types.d.ts.map +0 -0
  78. package/memory/_digest.md +1 -1
  79. package/memory/_templates/handoff.md +0 -0
  80. package/memory/_templates/plan.md +35 -0
  81. package/memory/_templates/prd.md +0 -0
  82. package/memory/_templates/research.md +0 -0
  83. package/memory/_templates/review.md +0 -0
  84. package/memory/_templates/spec.md +12 -0
  85. package/memory/beads/.gitkeep +0 -0
  86. package/memory/handoffs/.gitkeep +0 -0
  87. package/memory/memory.db +0 -0
  88. package/memory/plans/.gitkeep +0 -0
  89. package/memory/prds/.gitkeep +0 -0
  90. package/memory/research/.gitkeep +0 -0
  91. package/memory/reviews/.gitkeep +0 -0
  92. package/memory/specs/.gitkeep +0 -0
  93. package/package.json +4 -4
  94. package/skill/beads/SKILL.md +42 -43
  95. package/skill/beads/mcp.json +26 -0
  96. package/skill/beads/references/api-reference.md +64 -0
  97. package/skill/chrome-devtools/SKILL.md +22 -23
  98. package/skill/chrome-devtools/mcp.json +17 -0
  99. package/skill/chrome-devtools/references/tool-reference.md +63 -0
  100. package/skill/condition-based-waiting/SKILL.md +28 -66
  101. package/skill/deep-research/SKILL.md +34 -103
  102. package/skill/deep-research/mcp.json +21 -0
  103. package/skill/deep-research/references/lsp-ops.md +44 -0
  104. package/skill/defense-in-depth/SKILL.md +29 -69
  105. package/skill/executing-plans/SKILL.md +25 -34
  106. package/skill/finishing-a-development-branch/SKILL.md +28 -89
  107. package/skill/playwright/SKILL.md +27 -22
  108. package/skill/playwright/mcp.json +20 -0
  109. package/skill/playwright/references/tool-reference.md +64 -0
  110. package/skill/receiving-code-review/SKILL.md +16 -27
  111. package/skill/requesting-code-review/SKILL.md +22 -26
  112. package/skill/ritual-workflow/SKILL.md +22 -82
  113. package/skill/root-cause-tracing/SKILL.md +30 -54
  114. package/skill/session-management/SKILL.md +21 -40
  115. package/skill/source-code-research/SKILL.md +33 -102
  116. package/skill/source-code-research/mcp.json +13 -0
  117. package/skill/source-code-research/references/quick-ref.md +65 -0
  118. package/skill/systematic-debugging/SKILL.md +28 -41
  119. package/skill/systematic-debugging/references/patterns.md +71 -0
  120. package/skill/test-driven-development/SKILL.md +16 -40
  121. package/skill/testing-anti-patterns/SKILL.md +36 -64
  122. package/skill/testing-anti-patterns/references/decision-matrix.md +55 -0
  123. package/skill/using-git-worktrees/SKILL.md +27 -103
  124. package/skill/vercel-react-best-practices/SKILL.md +50 -139
  125. package/skill/vercel-react-best-practices/references/patterns.md +70 -0
  126. package/skill/verification-before-completion/SKILL.md +19 -37
  127. package/skill/writing-plans/SKILL.md +20 -32
  128. package/skill/writing-skills/SKILL.md +52 -41
  129. package/skill/writing-skills/references/skill-anatomy.md +210 -0
  130. package/src/agents/AGENTS.md +48 -18
  131. package/src/agents/build.md +342 -93
  132. package/src/agents/explore.md +77 -60
  133. package/src/agents/index.ts +0 -0
  134. package/src/agents/oracle.md +153 -63
  135. package/src/agents/plan.md +275 -110
  136. package/src/agents/research.md +72 -52
  137. package/src/agents/review.md +182 -61
  138. package/src/agents/vision.md +7 -5
  139. package/command/plan.md +0 -152
  140. package/command/review-codebase.md +0 -228
  141. package/command/review.md +0 -135
  142. package/command/vision.md +0 -210
  143. package/dist/hooks/swarm-enforcer.d.ts +0 -31
  144. package/dist/hooks/swarm-enforcer.d.ts.map +0 -1
  145. package/dist/tools/beads-memory-sync.d.ts +0 -17
  146. package/dist/tools/beads-memory-sync.d.ts.map +0 -1
  147. package/dist/tools/quick-research.d.ts +0 -16
  148. package/dist/tools/quick-research.d.ts.map +0 -1
  149. package/dist/tools/swarm.d.ts +0 -57
  150. package/dist/tools/swarm.d.ts.map +0 -1
  151. package/skill/accessibility-audit/SKILL.md +0 -115
  152. package/skill/beads-bridge/SKILL.md +0 -45
  153. package/skill/brainstorming/SKILL.md +0 -41
  154. package/skill/cass-village/SKILL.md +0 -217
  155. package/skill/cloudflare/SKILL.md +0 -96
  156. package/skill/design-system-audit/SKILL.md +0 -136
  157. package/skill/development-lifecycle/SKILL.md +0 -58
  158. package/skill/dispatching-parallel-agents/SKILL.md +0 -94
  159. package/skill/figma/SKILL.md +0 -34
  160. package/skill/frontend-aesthetics/SKILL.md +0 -63
  161. package/skill/gemini-large-context/SKILL.md +0 -80
  162. package/skill/mockup-to-code/SKILL.md +0 -98
  163. package/skill/mqdh/SKILL.md +0 -54
  164. package/skill/notebooklm/SKILL.md +0 -71
  165. package/skill/playwriter/SKILL.md +0 -56
  166. package/skill/polar/SKILL.md +0 -39
  167. package/skill/resend/SKILL.md +0 -85
  168. package/skill/sharing-skills/SKILL.md +0 -50
  169. package/skill/subagent-driven-development/SKILL.md +0 -69
  170. package/skill/supabase/SKILL.md +0 -80
  171. package/skill/supabase-postgres-best-practices/SKILL.md +0 -168
  172. package/skill/swarm-coordination/SKILL.md +0 -54
  173. package/skill/testing-skills-with-subagents/SKILL.md +0 -102
  174. package/skill/ui-ux-research/SKILL.md +0 -93
  175. package/skill/v0/SKILL.md +0 -67
  176. package/skill/v1-run/SKILL.md +0 -85
  177. package/skill/visual-analysis/SKILL.md +0 -113
@@ -1,80 +0,0 @@
1
- ---
2
- name: gemini-large-context
3
- description: Use when context exceeds session limits or analyzing 100KB+ files. Leverages Gemini CLI's 1M token window.
4
- ---
5
-
6
- # Gemini Large Context Skill
7
-
8
- You are running the **gemini-large-context** skill. When you hit limits, scale up.
9
-
10
- ## When to Use
11
-
12
- | Scenario | Why Gemini |
13
- |----------|------------|
14
- | Single file >100KB | Won't fit in standard context |
15
- | Project-wide pattern search | Need full codebase visibility |
16
- | Multi-file diff analysis | Compare across dozens of files |
17
- | Legacy code archaeology | Understand decade-old systems |
18
- | Full test suite review | See all tests at once |
19
-
20
- ## Process
21
-
22
- ### 1. Prepare Input
23
-
24
- ```bash
25
- # Single large file
26
- gemini -p "Analyze this file for [task]: $(cat large_file.ts)"
27
-
28
- # Multiple files
29
- cat file1.ts file2.ts file3.ts | gemini -p "Compare these files:"
30
-
31
- # Full directory
32
- find src -name "*.ts" -exec cat {} \; | gemini -p "Find patterns in codebase:"
33
- ```
34
-
35
- ### 2. Structure Your Prompt
36
-
37
- ```
38
- Context: [what you're analyzing]
39
- Task: [specific question or goal]
40
- Constraints: [limitations, requirements]
41
- Output: [expected format]
42
- ```
43
-
44
- ### 3. Handle Output
45
-
46
- - Gemini returns full analysis
47
- - Extract actionable items
48
- - If incomplete, prompt for continuation
49
- - Save important findings to memory
50
-
51
- ## Use Cases
52
-
53
- ### Large File Analysis
54
- ```
55
- gemini -p "Map all exports and their dependencies in this file: $(cat huge_api.ts)"
56
- ```
57
-
58
- ### Pattern Detection
59
- ```
60
- cat src/**/*.ts | gemini -p "Find all authentication patterns and security issues:"
61
- ```
62
-
63
- ### Multi-file Comparison
64
- ```
65
- cat v1/api.ts v2/api.ts | gemini -p "Breaking changes between v1 and v2:"
66
- ```
67
-
68
- ## Checklist
69
-
70
- - [ ] Confirmed file/directory size justifies large context
71
- - [ ] Prompt includes specific task (not "analyze this")
72
- - [ ] Output format specified
73
- - [ ] Results saved to `.opencode/memory/` for reference
74
-
75
- ## Red Flags
76
-
77
- - Using for small files (wastes resources)
78
- - Vague prompts ("what do you think?")
79
- - Not saving results (lose context on next session)
80
- - Ignoring token limits still exists (1M isn't infinite)
@@ -1,98 +0,0 @@
1
- ---
2
- name: mockup-to-code
3
- description: Use when converting UI mockups, screenshots, or Figma/Sketch designs into production-ready code.
4
- ---
5
-
6
- # Mockup to Code Skill
7
-
8
- You are running the **mockup-to-code** skill. Pixels to production.
9
-
10
- ## Input Types
11
-
12
- | Source | Extraction Method |
13
- |--------|-------------------|
14
- | Screenshot | Visual analysis via Gemini |
15
- | Figma export | Design tokens + component mapping |
16
- | Sketch file | Layer structure + styles |
17
- | Design URL | Direct inspection or screenshot |
18
-
19
- ## Process
20
-
21
- ### 1. Extract Design Tokens
22
-
23
- ```bash
24
- gemini -p "Extract design tokens from this mockup as JSON: $(cat mockup.png)"
25
- ```
26
-
27
- Expected output structure:
28
- ```json
29
- {
30
- "colors": { "primary": "#...", "secondary": "#..." },
31
- "typography": { "heading": "...", "body": "..." },
32
- "spacing": { "base": 8, "scale": [8, 16, 24, 32] },
33
- "shadows": ["0 2px 4px rgba(...)", ...],
34
- "radii": [4, 8, 16]
35
- }
36
- ```
37
-
38
- ### 2. Identify Components
39
-
40
- ```
41
- Component: [Name]
42
- - Props: [list]
43
- - Variants: [list]
44
- - States: [default, hover, active, disabled]
45
- - Dependencies: [child components]
46
- ```
47
-
48
- ### 3. Map to Tech Stack
49
-
50
- | Design Element | Implementation |
51
- |----------------|----------------|
52
- | Typography | Tailwind classes / CSS variables |
53
- | Colors | CSS custom properties |
54
- | Spacing | Tailwind spacing scale |
55
- | Components | React/Vue/Svelte components |
56
- | Icons | Lucide / Heroicons / custom SVG |
57
-
58
- ### 4. Build Incrementally
59
-
60
- 1. Structure: Semantic HTML
61
- 2. Layout: Flexbox/Grid
62
- 3. Styling: Tokens → classes
63
- 4. Interaction: States and events
64
- 5. Responsive: Breakpoint adjustments
65
- 6. Polish: Animations and details
66
-
67
- ## Component Library Handling
68
-
69
- ### Existing Library
70
- - Check for matching components first
71
- - Extend or compose before creating new
72
- - Document any custom overrides
73
-
74
- ### New Components
75
- - Follow existing patterns
76
- - Use established tokens
77
- - Ensure accessibility built-in
78
-
79
- ## Checklist
80
-
81
- - [ ] Design tokens extracted and defined
82
- - [ ] Components identified and documented
83
- - [ ] Semantic HTML structure
84
- - [ ] Responsive breakpoints handled
85
- - [ ] All interactive states implemented
86
- - [ ] Accessibility attributes added
87
- - [ ] Matches mockup pixel-perfectly
88
- - [ ] Code follows project conventions
89
-
90
- ## Red Flags
91
-
92
- - Skipping semantic HTML for div soup
93
- - Hardcoded values instead of tokens
94
- - Ignoring component library
95
- - Missing interactive states
96
- - No accessibility attributes
97
- - Inline styles over classes
98
- - Breaking responsive behavior
@@ -1,54 +0,0 @@
1
- ---
2
- name: mqdh
3
- description: Use when building Meta Quest VR/AR applications, needing Meta Horizon OS documentation, or managing Quest devices via ADB.
4
- ---
5
-
6
- # Meta Quest Developer Hub (MQDH) Skill
7
-
8
- MCP integration for Meta Quest Developer Hub providing VR/AR development tools, documentation access, and device management capabilities.
9
-
10
- ## Capabilities
11
-
12
- - **Documentation Access**: Query Meta Horizon OS and XR development docs
13
- - **ADB Tools**: Device debugging, app installation, log streaming
14
- - **Device Management**: Connect, configure, and manage Quest devices
15
- - **Build Tools**: APK management, app deployment workflows
16
- - **Debugging**: Performance profiling, log analysis
17
- - **Project Setup**: Quest project scaffolding and configuration
18
-
19
- ## When to Use
20
-
21
- - Building applications for Meta Quest headsets
22
- - Looking up Meta XR SDK documentation
23
- - Debugging Quest applications on device
24
- - Managing Quest device settings and configurations
25
- - Deploying builds to Quest devices
26
- - Setting up XR development environments
27
-
28
- ## Key Tools
29
-
30
- - `query_docs`: Search Meta Horizon OS documentation
31
- - `device_list`: List connected Quest devices
32
- - `device_install`: Install APK to device
33
- - `device_logs`: Stream device logs
34
- - `adb_command`: Execute ADB commands
35
- - `project_configure`: Set up Quest project settings
36
-
37
- ## Example Usage
38
-
39
- ```
40
- // Query documentation
41
- query_docs({ query: "hand tracking setup Quest 3" })
42
-
43
- // Install app
44
- device_install({ apk_path: "./build/app.apk", device_id: "quest-3" })
45
-
46
- // Stream logs
47
- device_logs({ device_id: "quest-3", filter: "Unity" })
48
- ```
49
-
50
- ## Prerequisites
51
-
52
- - Meta Quest Developer Hub installed
53
- - Developer mode enabled on Quest device
54
- - USB connection or ADB over Wi-Fi configured
@@ -1,71 +0,0 @@
1
- ---
2
- name: notebooklm
3
- description: Use when querying Google NotebookLM notebooks for source-grounded answers with citations, or managing notebook libraries.
4
- ---
5
-
6
- # NotebookLM Skill
7
-
8
- Query Google NotebookLM notebooks for source-grounded, citation-backed answers. Provides browser automation for notebook access, library management, and persistent authentication.
9
-
10
- ## Capabilities
11
-
12
- - **Query Notebooks**: Ask questions against uploaded sources
13
- - **Citation-Backed Answers**: Responses reference specific source documents
14
- - **Notebook Management**: Create, update, delete notebooks
15
- - **Source Management**: Add/remove sources from notebooks
16
- - **Persistent Auth**: Maintain Google session across sessions
17
- - **Library Access**: Browse and search notebook collections
18
-
19
- ## When to Use
20
-
21
- - Research with document-grounded answers
22
- - Querying knowledge bases with citations
23
- - Extracting insights from uploaded documents
24
- - Building research workflows
25
- - Creating Q&A systems from documents
26
- - Getting answers with verifiable sources
27
-
28
- ## Key Tools
29
-
30
- - `query_notebook`: Ask questions to a specific notebook
31
- - `list_notebooks`: Get all available notebooks
32
- - `create_notebook`: Create new notebook with sources
33
- - `add_sources`: Add documents/URLs to notebook
34
- - `get_answer_sources`: Retrieve citations for an answer
35
-
36
- ## Example Usage
37
-
38
- ```
39
- // Query notebook
40
- query_notebook({
41
- notebook_id: "research-papers",
42
- question: "What are the key findings about LLM hallucinations?"
43
- })
44
-
45
- // Returns answer with citations:
46
- // "According to Source 1, LLM hallucinations occur when..."
47
- // Citations: [Source 1, p.3], [Source 2, Section 4.2]
48
-
49
- // List notebooks
50
- list_notebooks()
51
-
52
- // Create notebook
53
- create_notebook({
54
- name: "Project Documentation",
55
- sources: ["https://docs.example.com", "./local-docs/"]
56
- })
57
- ```
58
-
59
- ## Authentication
60
-
61
- - Browser-based OAuth flow
62
- - Session persistence in secure storage
63
- - Automatic token refresh
64
- - Supports multiple Google accounts
65
-
66
- ## Notes
67
-
68
- - Requires Google account access
69
- - Browser automation handles auth
70
- - Source limits based on NotebookLM tiers
71
- - Answers grounded in uploaded sources only
@@ -1,56 +0,0 @@
1
- ---
2
- name: playwriter
3
- description: Use when automating browser interactions, web scraping, or testing with existing Chrome sessions. 90% less context than traditional browser MCP.
4
- ---
5
-
6
- # Playwriter Skill
7
-
8
- Browser automation via Chrome extension integration. Provides a single `execute` tool with full Playwright API access while using your existing browser with all extensions, sessions, and cookies intact.
9
-
10
- ## Capabilities
11
-
12
- - **Session Reuse**: Works with your logged-in browser sessions
13
- - **Extension Support**: Full access to Chrome extensions during automation
14
- - **Full Playwright API**: Navigation, clicks, inputs, screenshots, waits
15
- - **Cookie Persistence**: No need to re-authenticate
16
- - **Lightweight**: Minimal context usage compared to traditional browser MCPs
17
-
18
- ## When to Use
19
-
20
- - Web scraping behind logins
21
- - Automating repetitive browser tasks
22
- - Testing web applications with existing sessions
23
- - Taking screenshots of authenticated pages
24
- - Form filling and submission
25
- - Multi-step browser workflows
26
-
27
- ## Usage Pattern
28
-
29
- ```
30
- Use the execute tool with Playwright-style commands:
31
- - navigate(url)
32
- - click(selector)
33
- - fill(selector, value)
34
- - screenshot()
35
- - wait(selector)
36
- - evaluate(script)
37
- ```
38
-
39
- ## Example
40
-
41
- ```javascript
42
- execute({
43
- actions: [
44
- { type: "navigate", url: "https://example.com/dashboard" },
45
- { type: "wait", selector: ".data-table" },
46
- { type: "screenshot", path: "dashboard.png" }
47
- ]
48
- })
49
- ```
50
-
51
- ## Notes
52
-
53
- - Requires Chrome extension installation
54
- - Browser must be running with remote debugging enabled
55
- - Supports headless and headed modes
56
- - Maintains state between execute calls
@@ -1,39 +0,0 @@
1
- ---
2
- name: polar
3
- description: Use for Polar payment integration, subscriptions, license keys, and customer portal implementation.
4
- ---
5
-
6
- # Polar Skill
7
-
8
- You are running the **polar** skill. Polar payment platform integration.
9
-
10
- ## Capabilities
11
-
12
- | Action | Description |
13
- |--------|-------------|
14
- | Create products | Define products, pricing, billing cycles |
15
- | Implement checkout | Embedded checkout, custom flows |
16
- | Manage subscriptions | Create, update, cancel, webhook handling |
17
- | License keys | Generate, validate, manage keys |
18
- | Customer portal | Self-service billing management |
19
-
20
- ## Usage
21
-
22
- 1. Configure Polar credentials in environment
23
- 2. Create or reference products in Polar dashboard
24
- 3. Implement checkout flow with webhooks
25
- 4. Handle subscription state in your app
26
-
27
- ## Key Integration Points
28
-
29
- - Checkout: `POST /checkout/`
30
- - Webhooks: subscription events, payment status
31
- - License validation: server-side key verification
32
- - Customer portal: embeddable billing UI
33
-
34
- ## Best Practices
35
-
36
- - Always verify webhooks using signature validation
37
- - Store Polar IDs, not email addresses, for user linking
38
- - Handle all subscription states (active, past_due, canceled)
39
- - Test with Polar sandbox before production
@@ -1,85 +0,0 @@
1
- ---
2
- name: resend
3
- description: Use when sending transactional emails, receiving inbound emails, creating email templates with React Email, or handling email webhooks.
4
- ---
5
-
6
- # Resend Skill
7
-
8
- Comprehensive Resend email platform integration for transactional emails, inbound email handling, template management with React Email, and webhook processing.
9
-
10
- ## Capabilities
11
-
12
- - **Send Emails**: Transactional and bulk email sending
13
- - **Inbound Email**: Receive and process incoming emails
14
- - **React Email Templates**: Create emails with React components
15
- - **Webhook Handling**: Process email events (delivered, opened, bounced)
16
- - **Domain Management**: Configure sending domains and DNS
17
- - **Analytics**: Track email delivery and engagement metrics
18
-
19
- ## When to Use
20
-
21
- - Sending transactional emails (password resets, notifications)
22
- - Building email templates with React
23
- - Receiving and processing inbound emails
24
- - Setting up email webhooks
25
- - Managing sending domains
26
- - Implementing email workflows
27
-
28
- ## Key Tools
29
-
30
- - `send_email`: Send single or batch emails
31
- - `create_template`: Create React Email templates
32
- - `get_inbound`: Retrieve inbound emails
33
- - `list_domains`: Manage sending domains
34
- - `get_events`: Query email events
35
- - `create_webhook`: Set up event webhooks
36
-
37
- ## Example Usage
38
-
39
- ```
40
- // Send email
41
- send_email({
42
- to: "user@example.com",
43
- subject: "Welcome!",
44
- html: "<h1>Welcome aboard!</h1>",
45
- from: "noreply@myapp.com"
46
- })
47
-
48
- // React Email template
49
- create_template({
50
- name: "password-reset",
51
- component: "./emails/PasswordReset.tsx"
52
- })
53
-
54
- // Handle inbound
55
- get_inbound({
56
- limit: 10,
57
- status: "unread"
58
- })
59
- ```
60
-
61
- ## React Email Integration
62
-
63
- ```tsx
64
- // emails/Welcome.tsx
65
- import { Html, Body, Container, Text } from '@react-email/components';
66
-
67
- export default function Welcome({ name }) {
68
- return (
69
- <Html>
70
- <Body>
71
- <Container>
72
- <Text>Welcome, {name}!</Text>
73
- </Container>
74
- </Body>
75
- </Html>
76
- );
77
- }
78
- ```
79
-
80
- ## Notes
81
-
82
- - Requires Resend API key
83
- - Domain verification needed for sending
84
- - Supports attachments up to 40MB
85
- - Rate limits apply based on plan
@@ -1,50 +0,0 @@
1
- ---
2
- name: sharing-skills
3
- description: Use when contributing skills to the community. One skill per PR.
4
- ---
5
-
6
- # Sharing Skills Skill
7
-
8
- You are running the **sharing-skills** skill. Contribute effectively.
9
-
10
- ## When to Share
11
-
12
- - Broadly useful across projects
13
- - Solves common workflow problems
14
- - Encapsulates best practices
15
- - Not project-specific
16
-
17
- ## Keep Personal
18
-
19
- - Project-specific configurations
20
- - Team-specific conventions
21
- - Environment-dependent logic
22
- - One-off automations
23
-
24
- ## Contribution Workflow
25
-
26
- 1. **Branch** — Create feature branch from main
27
- 2. **Edit/Create** — Add or modify skill file
28
- 3. **Commit** — Clear commit message describing skill
29
- 4. **Push** — Push to your fork
30
- 5. **PR** — Open pull request with description
31
-
32
- ## PR Guidelines
33
-
34
- - One skill per PR
35
- - Include rationale in PR description
36
- - Reference any related issues
37
- - Be responsive to feedback
38
-
39
- ## Skill File Structure
40
-
41
- ```
42
- skill-name/
43
- SKILL.md
44
- ```
45
-
46
- ## Red Flags
47
-
48
- - Sharing project-specific skills as general
49
- - Bundling multiple skills in one PR
50
- - Not documenting when/why to use the skill
@@ -1,69 +0,0 @@
1
- ---
2
- name: subagent-driven-development
3
- description: Use when working on multi-task development cycles. Fresh subagent per task for fast iteration with code review between tasks via @review.
4
- ---
5
-
6
- # Subagent-Driven Development Skill
7
-
8
- You are running the **subagent-driven-development** skill. Work autonomously for hours with quality gates between tasks.
9
-
10
- ## Core Principle
11
-
12
- Fresh subagent per task. Each task is a clean slate with clear objectives. Code review between tasks via @review agent ensures quality accumulation.
13
-
14
- ## Workflow
15
-
16
- ### 1. Task Breakdown
17
- - Split work into discrete, completable tasks
18
- - Each task should be 15-30 minutes of work
19
- - Tasks should have clear success criteria
20
- - Order tasks by dependency
21
-
22
- ### 2. Task Execution Cycle
23
- ```
24
- For each task:
25
- 1. Spawn fresh subagent for task
26
- 2. Subagent completes task autonomously
27
- 3. Run @review for code quality check
28
- 4. Fix issues from review
29
- 5. Commit or stage changes
30
- 6. Move to next task
31
- ```
32
-
33
- ### 3. Quality Gates
34
- Between each task:
35
- - Run @review agent on changed files
36
- - Address all critical and high-priority issues
37
- - Verify tests pass
38
- - Confirm task completion criteria met
39
-
40
- ## Agent Autonomy
41
-
42
- The subagent works autonomously:
43
- - No mid-task questions to user
44
- - Make reasonable assumptions
45
- - Document decisions in code
46
- - Flag blockers only when truly stuck
47
-
48
- ## Benefits
49
-
50
- | Benefit | Why |
51
- |---------|-----|
52
- | Fresh context | No accumulated confusion |
53
- | Fast iteration | Quick task completion |
54
- | Quality accumulation | Review catches issues early |
55
- | Autonomous work | Hours of productive work |
56
-
57
- ## Anti-Patterns
58
-
59
- - Tasks too large (lose the benefit of fresh context)
60
- - Skipping review between tasks
61
- - Asking user for every decision
62
- - No clear success criteria per task
63
-
64
- ## When to Use
65
-
66
- - Multi-hour development sessions
67
- - Features with multiple components
68
- - Refactoring with clear steps
69
- - Bug fix chains with review gates
@@ -1,80 +0,0 @@
1
- ---
2
- name: supabase
3
- description: Use when working with Supabase databases, edge functions, authentication, real-time subscriptions, or managing Supabase projects.
4
- ---
5
-
6
- # Supabase Skill
7
-
8
- Comprehensive Supabase platform MCP covering database operations, edge functions, authentication, real-time features, development tools, debugging, and project management.
9
-
10
- ## Capabilities
11
-
12
- - **Database Operations**: Query, migrate, manage PostgreSQL
13
- - **Edge Functions**: Deploy, manage, debug serverless functions
14
- - **Authentication**: User management, auth providers, JWT handling
15
- - **Real-time**: Subscribe to database changes
16
- - **Storage**: File upload, management, signed URLs
17
- - **Development Tools**: Local development, type generation
18
- - **Debugging**: Logs, metrics, query analysis
19
-
20
- ## When to Use
21
-
22
- - Querying or modifying Supabase databases
23
- - Deploying and managing edge functions
24
- - Setting up authentication flows
25
- - Generating TypeScript types from schema
26
- - Debugging database queries and functions
27
- - Managing Supabase projects
28
-
29
- ## Key Tools
30
-
31
- - `query`: Execute SQL queries
32
- - `migrate`: Run database migrations
33
- - `deploy_function`: Deploy edge function
34
- - `generate_types`: Generate TypeScript types
35
- - `list_logs`: View function/database logs
36
- - `manage_auth`: User operations
37
-
38
- ## Example Usage
39
-
40
- ```
41
- // Query database
42
- query({
43
- sql: "SELECT * FROM users WHERE active = true LIMIT 10"
44
- })
45
-
46
- // Deploy edge function
47
- deploy_function({
48
- name: "send-notification",
49
- entrypoint: "./functions/send-notification/index.ts"
50
- })
51
-
52
- // Generate types
53
- generate_types({
54
- output: "./src/types/supabase.ts"
55
- })
56
-
57
- // Auth operations
58
- manage_auth({
59
- action: "create_user",
60
- email: "user@example.com",
61
- password: "secure123"
62
- })
63
- ```
64
-
65
- ## Development Workflow
66
-
67
- ```bash
68
- # Local development
69
- supabase start # Start local stack
70
- supabase db reset # Reset with migrations
71
- supabase functions serve # Local function dev
72
- supabase types gen # Generate types
73
- ```
74
-
75
- ## Notes
76
-
77
- - Requires Supabase project credentials
78
- - Supports both local and remote projects
79
- - Row Level Security policies respected
80
- - Connection pooling for serverless