thanh-kit 2.5.4 → 2.5.6
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.
- package/package.json +1 -1
- package/templates/command-archive/ask.md +56 -0
- package/templates/command-archive/ck-help.md +129 -0
- package/templates/command-archive/coding-level.md +48 -0
- package/templates/command-archive/docs/init.md +38 -0
- package/templates/command-archive/docs/summarize.md +22 -0
- package/templates/command-archive/docs/update.md +76 -0
- package/templates/command-archive/journal.md +18 -0
- package/templates/command-archive/kanban.md +99 -0
- package/templates/command-archive/plan/archive.md +57 -0
- package/templates/command-archive/plan/red-team.md +200 -0
- package/templates/command-archive/plan/validate.md +188 -0
- package/templates/command-archive/preview.md +283 -0
- package/templates/command-archive/review/codebase/parallel.md +122 -0
- package/templates/command-archive/review/codebase.md +49 -0
- package/templates/command-archive/test/ui.md +92 -0
- package/templates/command-archive/test.md +8 -0
- package/templates/command-archive/use-mcp.md +38 -0
- package/templates/command-archive/watzup.md +8 -0
- package/templates/command-archive/worktree.md +109 -0
- package/templates/hooks/.logs/hook-log.jsonl +31 -0
- package/templates/settings.local.json +13 -0
- package/templates/skills/agent-browser/SKILL.md +1 -1
- package/templates/skills/ai-artist/SKILL.md +1 -1
- package/templates/skills/ai-multimodal/SKILL.md +1 -1
- package/templates/skills/ask/SKILL.md +1 -1
- package/templates/skills/backend-development/SKILL.md +1 -1
- package/templates/skills/better-auth/SKILL.md +1 -1
- package/templates/skills/bootstrap/SKILL.md +1 -1
- package/templates/skills/brainstorm/SKILL.md +1 -1
- package/templates/skills/chrome-devtools/SKILL.md +1 -1
- package/templates/skills/ck-help/SKILL.md +1 -1
- package/templates/skills/code-review/SKILL.md +1 -1
- package/templates/skills/coding-level/SKILL.md +1 -1
- package/templates/skills/context-engineering/SKILL.md +1 -1
- package/templates/skills/cook/SKILL.md +1 -1
- package/templates/skills/copywriting/SKILL.md +1 -1
- package/templates/skills/databases/SKILL.md +1 -1
- package/templates/skills/debug/SKILL.md +1 -1
- package/templates/skills/devops/SKILL.md +1 -1
- package/templates/skills/docs/SKILL.md +1 -1
- package/templates/skills/docs-seeker/SKILL.md +1 -1
- package/templates/skills/document-skills/docx/SKILL.md +1 -1
- package/templates/skills/document-skills/pdf/SKILL.md +1 -1
- package/templates/skills/document-skills/pptx/SKILL.md +1 -1
- package/templates/skills/document-skills/xlsx/SKILL.md +1 -1
- package/templates/skills/find-skills/SKILL.md +1 -1
- package/templates/skills/fix/SKILL.md +1 -1
- package/templates/skills/frontend-design/SKILL.md +1 -1
- package/templates/skills/frontend-development/SKILL.md +1 -1
- package/templates/skills/git/SKILL.md +1 -1
- package/templates/skills/gkg/SKILL.md +1 -1
- package/templates/skills/google-adk-python/SKILL.md +1 -1
- package/templates/skills/journal/SKILL.md +1 -1
- package/templates/skills/kanban/SKILL.md +1 -1
- package/templates/skills/markdown-novel-viewer/SKILL.md +1 -1
- package/templates/skills/mcp-builder/SKILL.md +1 -1
- package/templates/skills/mcp-management/SKILL.md +1 -1
- package/templates/skills/media-processing/SKILL.md +1 -1
- package/templates/skills/mermaidjs-v11/SKILL.md +1 -1
- package/templates/skills/mintlify/SKILL.md +1 -1
- package/templates/skills/mobile-development/SKILL.md +1 -1
- package/templates/skills/payment-integration/SKILL.md +1 -1
- package/templates/skills/plan/SKILL.md +1 -1
- package/templates/skills/plans-kanban/SKILL.md +1 -1
- package/templates/skills/preview/SKILL.md +1 -1
- package/templates/skills/problem-solving/SKILL.md +1 -1
- package/templates/skills/project-management/SKILL.md +1 -1
- package/templates/skills/react-best-practices/SKILL.md +1 -1
- package/templates/skills/remotion/SKILL.md +1 -1
- package/templates/skills/repomix/SKILL.md +1 -1
- package/templates/skills/research/SKILL.md +1 -1
- package/templates/skills/scout/SKILL.md +1 -1
- package/templates/skills/sequential-thinking/SKILL.md +1 -1
- package/templates/skills/shader/SKILL.md +1 -1
- package/templates/skills/shopify/SKILL.md +1 -1
- package/templates/skills/skill-creator/SKILL.md +1 -1
- package/templates/skills/tanstack/SKILL.md +1 -1
- package/templates/skills/team/SKILL.md +1 -1
- package/templates/skills/template-skill/SKILL.md +1 -1
- package/templates/skills/test/SKILL.md +1 -1
- package/templates/skills/threejs/SKILL.md +1 -1
- package/templates/skills/ui-styling/SKILL.md +1 -1
- package/templates/skills/ui-ux-pro-max/SKILL.md +1 -1
- package/templates/skills/use-mcp/SKILL.md +1 -1
- package/templates/skills/watzup/SKILL.md +1 -1
- package/templates/skills/web-design-guidelines/SKILL.md +1 -1
- package/templates/skills/web-frameworks/SKILL.md +2 -2
- package/templates/skills/web-testing/SKILL.md +1 -1
- package/templates/skills/worktree/SKILL.md +1 -1
- package/templates/commands/bootstrap/auto/fast.md +0 -111
- package/templates/commands/bootstrap/auto/parallel.md +0 -66
- package/templates/commands/bootstrap/auto.md +0 -115
- package/templates/commands/bootstrap.md +0 -137
- package/templates/commands/code/auto.md +0 -203
- package/templates/commands/code/no-test.md +0 -174
- package/templates/commands/code/parallel.md +0 -100
- package/templates/commands/code.md +0 -205
- package/templates/commands/content/cro.md +0 -43
- package/templates/commands/content/enhance.md +0 -14
- package/templates/commands/content/fast.md +0 -13
- package/templates/commands/content/good.md +0 -16
- package/templates/commands/cook/auto/fast.md +0 -26
- package/templates/commands/cook/auto/parallel.md +0 -49
- package/templates/commands/cook/auto.md +0 -15
- package/templates/commands/cook.md +0 -105
- package/templates/commands/debug.md +0 -13
- package/templates/commands/design/3d.md +0 -83
- package/templates/commands/design/describe.md +0 -23
- package/templates/commands/design/fast.md +0 -31
- package/templates/commands/design/good.md +0 -35
- package/templates/commands/design/screenshot.md +0 -34
- package/templates/commands/design/video.md +0 -34
- package/templates/commands/fix/ci.md +0 -17
- package/templates/commands/fix/fast.md +0 -19
- package/templates/commands/fix/hard.md +0 -39
- package/templates/commands/fix/logs.md +0 -26
- package/templates/commands/fix/parallel.md +0 -54
- package/templates/commands/fix/test.md +0 -20
- package/templates/commands/fix/types.md +0 -9
- package/templates/commands/fix/ui.md +0 -48
- package/templates/commands/fix.md +0 -43
- package/templates/commands/plan/ci.md +0 -33
- package/templates/commands/plan/cro.md +0 -69
- package/templates/commands/plan/fast.md +0 -82
- package/templates/commands/plan/hard.md +0 -108
- package/templates/commands/plan/parallel.md +0 -145
- package/templates/commands/plan/two.md +0 -45
- package/templates/commands/plan.md +0 -30
- package/templates/commands/scout/ext.md +0 -39
- package/templates/commands/scout.md +0 -28
- package/templates/commands/skill/add.md +0 -36
- package/templates/commands/skill/create.md +0 -29
- package/templates/commands/skill/fix-logs.md +0 -22
- package/templates/commands/skill/optimize/auto.md +0 -25
- package/templates/commands/skill/optimize.md +0 -34
- package/templates/commands/skill/update.md +0 -36
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: ⚡⚡⚡ Ultrathink edge cases, then parallel verify with code-reviewers
|
|
3
|
+
argument-hint: [scope-or-prompt]
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
**Ultrathink** to exhaustively list ALL potential edge cases, then dispatch parallel `code-reviewer` agents to verify: <scope>$ARGUMENTS</scope>
|
|
7
|
+
|
|
8
|
+
**IMPORTANT:** Activate needed skills. Ensure token efficiency. Sacrifice grammar for concision.
|
|
9
|
+
|
|
10
|
+
## Workflow
|
|
11
|
+
|
|
12
|
+
### 1. Ultrathink Edge Cases
|
|
13
|
+
|
|
14
|
+
Main agent deeply analyzes the scope to LIST all potential edge cases FIRST:
|
|
15
|
+
- Read `codebase-summary.md` for context
|
|
16
|
+
- Use `/scout:ext` to find relevant files
|
|
17
|
+
- **Think exhaustively** about what could go wrong:
|
|
18
|
+
- Null/undefined scenarios
|
|
19
|
+
- Boundary conditions (off-by-one, empty, max values)
|
|
20
|
+
- Error handling gaps
|
|
21
|
+
- Race conditions, async edge cases
|
|
22
|
+
- Input validation holes
|
|
23
|
+
- Security vulnerabilities
|
|
24
|
+
- Resource leaks
|
|
25
|
+
- Untested code paths
|
|
26
|
+
|
|
27
|
+
**Output format:**
|
|
28
|
+
```markdown
|
|
29
|
+
## Edge Cases Identified
|
|
30
|
+
|
|
31
|
+
### Category: [scope-area]
|
|
32
|
+
1. [edge case description] → files: [file1, file2]
|
|
33
|
+
2. [edge case description] → files: [file3]
|
|
34
|
+
|
|
35
|
+
### Category: [another-area]
|
|
36
|
+
1. [edge case description] → files: [file4, file5]
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
### 2. Categorize & Assign
|
|
40
|
+
|
|
41
|
+
Group edge cases by similar scope for parallel verification:
|
|
42
|
+
- Each category → one `code-reviewer` agent
|
|
43
|
+
- Max 6 categories (merge small ones)
|
|
44
|
+
- Each reviewer gets specific edge cases to VERIFY, not discover
|
|
45
|
+
|
|
46
|
+
### 3. Parallel Verification
|
|
47
|
+
|
|
48
|
+
Launch N `code-reviewer` subagents simultaneously:
|
|
49
|
+
- Pass: category name, list of edge cases, relevant files
|
|
50
|
+
- Task: **VERIFY** if each edge case is properly handled in code
|
|
51
|
+
- Report: which edge cases are handled vs unhandled
|
|
52
|
+
|
|
53
|
+
**Reviewer instruction:**
|
|
54
|
+
```
|
|
55
|
+
Verify these specific edge cases in the given files:
|
|
56
|
+
[list of edge cases]
|
|
57
|
+
|
|
58
|
+
For each, report:
|
|
59
|
+
- ✅ Handled: [how it's handled]
|
|
60
|
+
- ❌ Unhandled: [what's missing]
|
|
61
|
+
- ⚠️ Partial: [what needs improvement]
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
### 4. Aggregate Results
|
|
65
|
+
|
|
66
|
+
Collect all verification reports:
|
|
67
|
+
```markdown
|
|
68
|
+
## Edge Case Verification Report
|
|
69
|
+
|
|
70
|
+
### Summary
|
|
71
|
+
- Total edge cases: X
|
|
72
|
+
- Handled: Y ✅
|
|
73
|
+
- Unhandled: Z ❌
|
|
74
|
+
- Partial: W ⚠️
|
|
75
|
+
|
|
76
|
+
### Unhandled Edge Cases (Need Fix)
|
|
77
|
+
| # | Edge Case | File | Status |
|
|
78
|
+
|---|-----------|------|--------|
|
|
79
|
+
| 1 | ... | ... | ❌ |
|
|
80
|
+
|
|
81
|
+
### Partial Handling (Need Review)
|
|
82
|
+
| # | Edge Case | File | Issue |
|
|
83
|
+
|---|-----------|------|-------|
|
|
84
|
+
| 1 | ... | ... | ... |
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### 5. Auto-Fix Pipeline
|
|
88
|
+
|
|
89
|
+
**IF** unhandled/partial edge cases found:
|
|
90
|
+
- Ask: "Found N unhandled edge cases. Fix with /fix --parallel? [Y/n]"
|
|
91
|
+
- **IF yes:** Trigger `/fix --parallel` with unhandled list
|
|
92
|
+
|
|
93
|
+
### 6. Final Report
|
|
94
|
+
|
|
95
|
+
- Summary of verification
|
|
96
|
+
- Ask: "Commit? [Y/n]" → use `git-manager`
|
|
97
|
+
|
|
98
|
+
## Example
|
|
99
|
+
|
|
100
|
+
```
|
|
101
|
+
User: /review:codebase:parallel auth module
|
|
102
|
+
|
|
103
|
+
1. Ultrathink → Lists 12 edge cases for auth:
|
|
104
|
+
- Empty password submission
|
|
105
|
+
- Token expiry during request
|
|
106
|
+
- Concurrent login attempts
|
|
107
|
+
- Invalid refresh token
|
|
108
|
+
...
|
|
109
|
+
|
|
110
|
+
2. Categorize → 3 groups:
|
|
111
|
+
- Login flow (4 cases)
|
|
112
|
+
- Token handling (5 cases)
|
|
113
|
+
- Session management (3 cases)
|
|
114
|
+
|
|
115
|
+
3. Parallel → 3 code-reviewers verify simultaneously
|
|
116
|
+
|
|
117
|
+
4. Aggregate → 8 handled, 3 unhandled, 1 partial
|
|
118
|
+
|
|
119
|
+
5. Fix → User approves → /fix --parallel
|
|
120
|
+
|
|
121
|
+
6. Final → Commit changes
|
|
122
|
+
```
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: ⚡⚡⚡ Scan & analyze the codebase.
|
|
3
|
+
argument-hint: [tasks-or-prompt]
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
Think harder to scan the codebase and analyze it follow the Orchestration Protocol, Core Responsibilities, Subagents Team and Development Rules:
|
|
7
|
+
<tasks>$ARGUMENTS</tasks>
|
|
8
|
+
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
## Role Responsibilities
|
|
12
|
+
- You are an elite software engineering expert who specializes in system architecture design and technical decision-making.
|
|
13
|
+
- You operate by the holy trinity of software engineering: **YAGNI** (You Aren't Gonna Need It), **KISS** (Keep It Simple, Stupid), and **DRY** (Don't Repeat Yourself). Every solution you propose must honor these principles.
|
|
14
|
+
- **IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
|
|
15
|
+
- **IMPORTANT:** In reports, list any unresolved questions at the end, if any.
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
## Workflow:
|
|
20
|
+
|
|
21
|
+
**IMPORTANT:** Analyze the skills catalog and activate the skills that are needed for the task during the process.
|
|
22
|
+
|
|
23
|
+
### Research
|
|
24
|
+
|
|
25
|
+
* Use 2 `researcher` subagents in parallel to search up to max 5 sources for the user's request, idea validation, best practices, challenges, and find the best possible solutions.
|
|
26
|
+
* Keep every research markdown report concise (≤150 lines) while covering all requested topics and citations.
|
|
27
|
+
* Use `/scout:ext` (preferred) or `/scout` (fallback) slash command to search the codebase for files needed to complete the task
|
|
28
|
+
|
|
29
|
+
### Code Review
|
|
30
|
+
|
|
31
|
+
* After finishing, use multiple `code-reviewer` subagents in parallel to review code.
|
|
32
|
+
* If there are any issues, duplicate code, or security vulnerabilities, ask main agent to improve the code and repeat the "Testing" process until all tests pass.
|
|
33
|
+
* When all tests pass, code is reviewed, the tasks are completed, report back to user with a summary of the changes and explain everything briefly, ask user to review the changes and approve them.
|
|
34
|
+
* **IMPORTANT:** Sacrifice grammar for the sake of concision when writing outputs.
|
|
35
|
+
|
|
36
|
+
### Plan
|
|
37
|
+
* Use `planner` subagent to analyze reports from `researcher` and `scout` subagents to create an improvement plan following the progressive disclosure structure:
|
|
38
|
+
- Create a directory using naming pattern from `## Naming` section.
|
|
39
|
+
- Save the overview access point at `plan.md`, keep it generic, under 80 lines, and list each phase with status/progress and links.
|
|
40
|
+
- For each phase, add `phase-XX-phase-name.md` files containing sections (Context links, Overview with date/priority/statuses, Key Insights, Requirements, Architecture, Related code files, Implementation Steps, Todo list, Success Criteria, Risk Assessment, Security Considerations, Next steps).
|
|
41
|
+
|
|
42
|
+
### Final Report
|
|
43
|
+
* Report back to user with a summary of the changes and explain everything briefly, guide user to get started and suggest the next steps.
|
|
44
|
+
* Ask the user if they want to commit and push to git repository, if yes, use `git-manager` subagent to commit and push to git repository.
|
|
45
|
+
|
|
46
|
+
**REMEMBER**:
|
|
47
|
+
- You can always generate images with `ai-multimodal` skill on the fly for visual assets.
|
|
48
|
+
- You always read and analyze the generated assets with `ai-multimodal` skill to verify they meet requirements.
|
|
49
|
+
- For image editing (removing background, adjusting, cropping), use ImageMagick or similar tools as needed.
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: '⚡⚡ Run UI tests on a website & generate a detailed report.'
|
|
3
|
+
argument-hint: '[url] [options]'
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
Activate the chrome-devtools skill.
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Run comprehensive UI tests on a website and generate a detailed report.
|
|
10
|
+
|
|
11
|
+
## Arguments
|
|
12
|
+
- $1: URL - The URL of the website to test
|
|
13
|
+
- $2: OPTIONS - Optional test configuration (e.g., --headless, --mobile, --auth)
|
|
14
|
+
|
|
15
|
+
## Testing Protected Routes (Authentication)
|
|
16
|
+
|
|
17
|
+
For testing protected routes that require authentication, follow this workflow:
|
|
18
|
+
|
|
19
|
+
### Step 1: User Manual Login
|
|
20
|
+
Instruct the user to:
|
|
21
|
+
1. Open the target site in their browser
|
|
22
|
+
2. Log in manually with their credentials
|
|
23
|
+
3. Open browser DevTools (F12) → Application tab → Cookies/Storage
|
|
24
|
+
|
|
25
|
+
### Step 2: Extract Auth Credentials
|
|
26
|
+
Ask the user to provide one of:
|
|
27
|
+
- **Cookies**: Copy cookie values (name, value, domain)
|
|
28
|
+
- **Access Token**: Copy JWT/Bearer token from localStorage or cookies
|
|
29
|
+
- **Session Storage**: Copy relevant session keys
|
|
30
|
+
|
|
31
|
+
### Step 3: Inject Authentication
|
|
32
|
+
Use the `inject-auth.js` script to inject credentials before testing:
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
cd $SKILL_DIR # .claude/skills/chrome-devtools/scripts
|
|
36
|
+
|
|
37
|
+
# Option A: Inject cookies
|
|
38
|
+
node inject-auth.js --url https://example.com --cookies '[{"name":"session","value":"abc123","domain":".example.com"}]'
|
|
39
|
+
|
|
40
|
+
# Option B: Inject Bearer token
|
|
41
|
+
node inject-auth.js --url https://example.com --token "Bearer eyJhbGciOi..." --header Authorization --token-key access_token
|
|
42
|
+
|
|
43
|
+
# Option C: Inject localStorage
|
|
44
|
+
node inject-auth.js --url https://example.com --local-storage '{"auth_token":"xyz","user_id":"123"}'
|
|
45
|
+
|
|
46
|
+
# Combined (cookies + localStorage)
|
|
47
|
+
node inject-auth.js --url https://example.com --cookies '[{"name":"session","value":"abc"}]' --local-storage '{"user":"data"}'
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
### Step 4: Run Tests
|
|
51
|
+
After auth injection, the browser session persists. Run tests normally:
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
# Navigate and screenshot protected pages
|
|
55
|
+
node navigate.js --url https://example.com/dashboard
|
|
56
|
+
node screenshot.js --url https://example.com/profile --output profile.png
|
|
57
|
+
|
|
58
|
+
# The auth session persists until --close true is used
|
|
59
|
+
node screenshot.js --url https://example.com/settings --output settings.png --close true
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
### Auth Script Options
|
|
63
|
+
- `--cookies '<json>'` - Inject cookies (JSON array)
|
|
64
|
+
- `--token '<token>'` - Inject Bearer token
|
|
65
|
+
- `--token-key '<key>'` - localStorage key for token (default: access_token)
|
|
66
|
+
- `--header '<name>'` - Set HTTP header with token (e.g., Authorization)
|
|
67
|
+
- `--local-storage '<json>'` - Inject localStorage items
|
|
68
|
+
- `--session-storage '<json>'` - Inject sessionStorage items
|
|
69
|
+
- `--reload true` - Reload page after injection
|
|
70
|
+
- `--clear true` - Clear saved auth session
|
|
71
|
+
|
|
72
|
+
## Workflow
|
|
73
|
+
- Use `plan` skill to organize the test plan & report in the current project directory.
|
|
74
|
+
- All the screenshots should be saved in the same report directory.
|
|
75
|
+
- Browse $URL with the specified $OPTIONS, discover all pages, components, and endpoints.
|
|
76
|
+
- Create a test plan based on the discovered structure
|
|
77
|
+
- Use multiple `tester` subagents or tool calls in parallel to test all pages, forms, navigation, user flows, accessibility, functionalities, usability, responsive layouts, cross-browser compatibility, performance, security, seo, etc.
|
|
78
|
+
- Use `ai-multimodal` to analyze all screenshots and visual elements.
|
|
79
|
+
- Generate a comprehensive report in Markdown format, embedding all screenshots directly in the report.
|
|
80
|
+
- Finally respond to the user with a concise summary of findings and recommendations.
|
|
81
|
+
- Use `AskUserQuestion` tool to ask if user wants to preview the report with `/preview` slash command.
|
|
82
|
+
|
|
83
|
+
## Output Requirements
|
|
84
|
+
How to write reports:
|
|
85
|
+
- Format: Use clear, structured Markdown with headers, lists, and code blocks where appropriate
|
|
86
|
+
- Include the test results summary, key findings, and screenshot references
|
|
87
|
+
- **IMPORTANT:** Ensure token efficiency while maintaining high quality.
|
|
88
|
+
- **IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
|
|
89
|
+
- **IMPORTANT:** In reports, list any unresolved questions at the end, if any.
|
|
90
|
+
|
|
91
|
+
**IMPORTANT**: **Do not** start implementing the fixes.
|
|
92
|
+
**IMPORTANT:** Analyze the skills catalog and activate the skills that are needed for the task during the process.
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: ⚡ Run tests locally and analyze the summary report.
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
Use the `tester` subagent to run tests locally and analyze the summary report.
|
|
6
|
+
|
|
7
|
+
**IMPORTANT**: **Do not** start implementing.
|
|
8
|
+
**IMPORTANT:** Analyze the skills catalog and activate the skills that are needed for the task during the process.
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Utilize tools of Model Context Protocol (MCP) servers
|
|
3
|
+
argument-hint: [task]
|
|
4
|
+
---
|
|
5
|
+
Execute MCP operations via **Gemini CLI** to preserve context budget.
|
|
6
|
+
|
|
7
|
+
## Execution Steps
|
|
8
|
+
|
|
9
|
+
1. **Execute task via Gemini CLI** (using stdin pipe for MCP support):
|
|
10
|
+
```bash
|
|
11
|
+
# IMPORTANT: Use stdin piping, NOT -p flag (deprecated, skips MCP init)
|
|
12
|
+
# Read model from .claude/.ck.json: gemini.model (default: gemini-3-flash-preview)
|
|
13
|
+
echo "$ARGUMENTS. Return JSON only per GEMINI.md instructions." | gemini -y -m <gemini.model>
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
2. **Fallback to mcp-manager subagent** (if Gemini CLI unavailable):
|
|
17
|
+
- Use `mcp-manager` subagent to discover and execute tools
|
|
18
|
+
- If the subagent got issues with the scripts of `mcp-management` skill, use `mcp-builder` skill to fix them
|
|
19
|
+
- **DO NOT** create ANY new scripts
|
|
20
|
+
- The subagent can only use MCP tools if any to achieve this task
|
|
21
|
+
- If the subagent can't find any suitable tools, just report it back to the main agent to move on to the next step
|
|
22
|
+
|
|
23
|
+
## Important Notes
|
|
24
|
+
|
|
25
|
+
- **MUST use stdin piping** - the deprecated `-p` flag skips MCP initialization
|
|
26
|
+
- Use `-y` flag to auto-approve tool execution
|
|
27
|
+
- **GEMINI.md auto-loaded**: Gemini CLI automatically loads `GEMINI.md` from project root, enforcing JSON-only response format
|
|
28
|
+
- **Parseable output**: Responses are structured JSON: `{"server":"name","tool":"name","success":true,"result":<data>,"error":null}`
|
|
29
|
+
|
|
30
|
+
## Anti-Pattern (DO NOT USE)
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
# BROKEN - deprecated -p flag skips MCP server connections!
|
|
34
|
+
gemini -y -m <gemini.model> -p "..."
|
|
35
|
+
|
|
36
|
+
# ALSO BROKEN - --model flag with -p
|
|
37
|
+
gemini -y -p "..." --model gemini-3-flash-preview
|
|
38
|
+
```
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: ⚡ Review recent changes and wrap up the work
|
|
3
|
+
---
|
|
4
|
+
Review my current branch and the most recent commits.
|
|
5
|
+
Provide a detailed summary of all changes, including what was modified, added, or removed.
|
|
6
|
+
Analyze the overall impact and quality of the changes.
|
|
7
|
+
|
|
8
|
+
**IMPORTANT**: **Do not** start implementing.
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: 'Create isolated git worktree for parallel development'
|
|
3
|
+
argument-hint: '[feature-description] OR [project] [feature] (monorepo)'
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
Create an isolated git worktree for parallel feature development.
|
|
7
|
+
|
|
8
|
+
## Workflow
|
|
9
|
+
|
|
10
|
+
### Step 1: Get Repo Info
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
node .claude/scripts/worktree.cjs info --json
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
Parse JSON response for: `repoType`, `baseBranch`, `projects`, `worktreeRoot`, `worktreeRootSource`.
|
|
17
|
+
|
|
18
|
+
### Step 2: Detect Branch Prefix
|
|
19
|
+
|
|
20
|
+
From user's description:
|
|
21
|
+
- "fix", "bug", "error", "issue" → `fix`
|
|
22
|
+
- "refactor", "restructure", "rewrite" → `refactor`
|
|
23
|
+
- "docs", "documentation", "readme" → `docs`
|
|
24
|
+
- "test", "spec", "coverage" → `test`
|
|
25
|
+
- "chore", "cleanup", "deps" → `chore`
|
|
26
|
+
- "perf", "performance", "optimize" → `perf`
|
|
27
|
+
- Default → `feat`
|
|
28
|
+
|
|
29
|
+
### Step 3: Convert to Slug
|
|
30
|
+
|
|
31
|
+
"add authentication system" → `add-auth`
|
|
32
|
+
"fix login bug" → `login-bug`
|
|
33
|
+
Max 50 chars, kebab-case.
|
|
34
|
+
|
|
35
|
+
### Step 4: Handle Monorepo
|
|
36
|
+
|
|
37
|
+
If `repoType === "monorepo"` and project not specified, use AskUserQuestion:
|
|
38
|
+
```javascript
|
|
39
|
+
AskUserQuestion({
|
|
40
|
+
questions: [{
|
|
41
|
+
header: "Project",
|
|
42
|
+
question: "Which project for the worktree?",
|
|
43
|
+
options: projects.map(p => ({ label: p.name, description: p.path })),
|
|
44
|
+
multiSelect: false
|
|
45
|
+
}]
|
|
46
|
+
})
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
### Step 5: Execute
|
|
50
|
+
|
|
51
|
+
**Monorepo:**
|
|
52
|
+
```bash
|
|
53
|
+
node .claude/scripts/worktree.cjs create "<PROJECT>" "<SLUG>" --prefix <TYPE>
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
**Standalone:**
|
|
57
|
+
```bash
|
|
58
|
+
node .claude/scripts/worktree.cjs create "<SLUG>" --prefix <TYPE>
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
**Options:**
|
|
62
|
+
- `--prefix` - Branch type: feat|fix|refactor|docs|test|chore|perf
|
|
63
|
+
- `--worktree-root <path>` - Override default location (only if needed)
|
|
64
|
+
- `--json` - JSON output
|
|
65
|
+
- `--dry-run` - Preview
|
|
66
|
+
|
|
67
|
+
### Step 6: Install Dependencies
|
|
68
|
+
|
|
69
|
+
Based on project context, run in background:
|
|
70
|
+
- `bun.lock` → `bun install`
|
|
71
|
+
- `pnpm-lock.yaml` → `pnpm install`
|
|
72
|
+
- `yarn.lock` → `yarn install`
|
|
73
|
+
- `package-lock.json` → `npm install`
|
|
74
|
+
- `poetry.lock` → `poetry install`
|
|
75
|
+
- `requirements.txt` → `pip install -r requirements.txt`
|
|
76
|
+
- `Cargo.toml` → `cargo build`
|
|
77
|
+
- `go.mod` → `go mod download`
|
|
78
|
+
|
|
79
|
+
## Commands
|
|
80
|
+
|
|
81
|
+
| Command | Usage | Description |
|
|
82
|
+
|---------|-------|-------------|
|
|
83
|
+
| `create` | `create [project] <feature>` | Create worktree |
|
|
84
|
+
| `remove` | `remove <name-or-path>` | Remove worktree |
|
|
85
|
+
| `info` | `info` | Repo info with worktree location |
|
|
86
|
+
| `list` | `list` | List worktrees |
|
|
87
|
+
|
|
88
|
+
## Example
|
|
89
|
+
|
|
90
|
+
```
|
|
91
|
+
User: /worktree fix the login validation bug
|
|
92
|
+
|
|
93
|
+
Claude: [Runs: node .claude/scripts/worktree.cjs info --json]
|
|
94
|
+
repoType: standalone
|
|
95
|
+
worktreeRoot: /home/user/worktrees
|
|
96
|
+
worktreeRootSource: sibling directory
|
|
97
|
+
|
|
98
|
+
[Prefix: fix, Slug: login-validation-bug]
|
|
99
|
+
[Runs: node .claude/scripts/worktree.cjs create "login-validation-bug" --prefix fix]
|
|
100
|
+
|
|
101
|
+
Output: Worktree created at /home/user/worktrees/my-project-login-validation-bug
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
## Notes
|
|
105
|
+
|
|
106
|
+
- Script auto-detects superproject, monorepo, and standalone repos
|
|
107
|
+
- Default worktree location is smart: superproject > monorepo > sibling
|
|
108
|
+
- Use `--worktree-root` only to override defaults
|
|
109
|
+
- Env templates (`.env*.example`) auto-copied with `.example` suffix removed
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
{"ts":"2026-03-04T16:03:43.971Z","hook":"scout-block","tool":"Bash","dur":4,"status":"ok","exit":0,"error":""}
|
|
2
|
+
{"ts":"2026-03-04T16:03:43.978Z","hook":"scout-block","tool":"Read","dur":3,"status":"ok","exit":0,"error":""}
|
|
3
|
+
{"ts":"2026-03-04T16:03:56.874Z","hook":"scout-block","tool":"Glob","dur":3,"status":"ok","exit":0,"error":""}
|
|
4
|
+
{"ts":"2026-03-04T16:03:56.880Z","hook":"scout-block","tool":"Bash","dur":7,"status":"block","exit":2,"error":""}
|
|
5
|
+
{"ts":"2026-03-04T16:03:57.560Z","hook":"scout-block","tool":"Bash","dur":4,"status":"ok","exit":0,"error":""}
|
|
6
|
+
{"ts":"2026-03-04T16:04:18.074Z","hook":"scout-block","tool":"Bash","dur":3,"status":"ok","exit":0,"error":""}
|
|
7
|
+
{"ts":"2026-03-04T16:04:18.082Z","hook":"scout-block","tool":"Read","dur":3,"status":"ok","exit":0,"error":""}
|
|
8
|
+
{"ts":"2026-03-04T16:04:26.893Z","hook":"scout-block","tool":"Bash","dur":7,"status":"block","exit":2,"error":""}
|
|
9
|
+
{"ts":"2026-03-04T16:04:32.226Z","hook":"scout-block","tool":"Bash","dur":6,"status":"block","exit":2,"error":""}
|
|
10
|
+
{"ts":"2026-03-04T16:04:32.234Z","hook":"scout-block","tool":"Read","dur":3,"status":"ok","exit":0,"error":""}
|
|
11
|
+
{"ts":"2026-03-04T16:04:44.444Z","hook":"scout-block","tool":"Read","dur":3,"status":"ok","exit":0,"error":""}
|
|
12
|
+
{"ts":"2026-03-04T16:04:44.445Z","hook":"scout-block","tool":"Read","dur":3,"status":"ok","exit":0,"error":""}
|
|
13
|
+
{"ts":"2026-03-04T16:04:56.769Z","hook":"scout-block","tool":"Bash","dur":4,"status":"ok","exit":0,"error":""}
|
|
14
|
+
{"ts":"2026-03-04T16:04:56.773Z","hook":"scout-block","tool":"Bash","dur":4,"status":"ok","exit":0,"error":""}
|
|
15
|
+
{"ts":"2026-03-04T16:11:33.817Z","hook":"scout-block","tool":"Bash","dur":4,"status":"ok","exit":0,"error":""}
|
|
16
|
+
{"ts":"2026-03-04T16:11:40.915Z","hook":"scout-block","tool":"Bash","dur":5,"status":"ok","exit":0,"error":""}
|
|
17
|
+
{"ts":"2026-03-04T16:13:15.301Z","hook":"scout-block","tool":"Bash","dur":4,"status":"ok","exit":0,"error":""}
|
|
18
|
+
{"ts":"2026-03-04T16:13:22.848Z","hook":"scout-block","tool":"Glob","dur":3,"status":"ok","exit":0,"error":""}
|
|
19
|
+
{"ts":"2026-03-04T16:13:22.859Z","hook":"scout-block","tool":"Read","dur":3,"status":"ok","exit":0,"error":""}
|
|
20
|
+
{"ts":"2026-03-04T16:13:25.718Z","hook":"scout-block","tool":"Read","dur":3,"status":"ok","exit":0,"error":""}
|
|
21
|
+
{"ts":"2026-03-04T16:13:25.719Z","hook":"scout-block","tool":"Read","dur":3,"status":"ok","exit":0,"error":""}
|
|
22
|
+
{"ts":"2026-03-04T16:13:54.959Z","hook":"scout-block","tool":"Bash","dur":4,"status":"ok","exit":0,"error":""}
|
|
23
|
+
{"ts":"2026-03-04T16:16:20.243Z","hook":"scout-block","tool":"Bash","dur":4,"status":"ok","exit":0,"error":""}
|
|
24
|
+
{"ts":"2026-03-04T16:18:06.224Z","hook":"scout-block","tool":"Read","dur":3,"status":"ok","exit":0,"error":""}
|
|
25
|
+
{"ts":"2026-03-04T16:18:27.165Z","hook":"scout-block","tool":"Glob","dur":3,"status":"block","exit":2,"error":""}
|
|
26
|
+
{"ts":"2026-03-04T16:18:27.166Z","hook":"scout-block","tool":"Bash","dur":2,"status":"ok","exit":0,"error":""}
|
|
27
|
+
{"ts":"2026-03-04T16:18:52.389Z","hook":"scout-block","tool":"Bash","dur":6,"status":"block","exit":2,"error":""}
|
|
28
|
+
{"ts":"2026-03-04T16:18:52.440Z","hook":"scout-block","tool":"Bash","dur":2,"status":"ok","exit":0,"error":""}
|
|
29
|
+
{"ts":"2026-03-04T16:19:00.919Z","hook":"scout-block","tool":"Read","dur":4,"status":"ok","exit":0,"error":""}
|
|
30
|
+
{"ts":"2026-03-04T16:19:10.452Z","hook":"scout-block","tool":"Edit","dur":3,"status":"ok","exit":0,"error":""}
|
|
31
|
+
{"ts":"2026-03-04T16:19:57.640Z","hook":"scout-block","tool":"Bash","dur":7,"status":"block","exit":2,"error":""}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: agent-browser
|
|
3
3
|
description: AI-optimized browser automation CLI with context-efficient snapshots. Use for long autonomous sessions, self-verifying workflows, video recording, and cloud browser testing (Browserbase).
|
|
4
4
|
license: Apache-2.0
|
|
5
5
|
argument-hint: "[url or task]"
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: ai-artist
|
|
3
3
|
description: "Generate images via Nano Banana with 129 curated prompts. Mandatory validation interview refines style/mood/colors (use --skip to bypass). 3 modes: search, creative, wild. Styles: Ukiyo-e, Bento grid, cyberpunk, cinematic, vintage patent."
|
|
4
4
|
version: 3.1.0
|
|
5
5
|
license: MIT
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: ai-multimodal
|
|
3
3
|
description: Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.
|
|
4
4
|
license: MIT
|
|
5
5
|
allowed-tools:
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: backend-development
|
|
3
3
|
description: Build backends with Node.js, Python, Go (NestJS, FastAPI, Django). Use for REST/GraphQL/gRPC APIs, auth (OAuth, JWT), databases, microservices, security (OWASP), Docker/K8s.
|
|
4
4
|
license: MIT
|
|
5
5
|
version: 1.0.0
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: bootstrap
|
|
3
3
|
description: "Bootstrap new projects with research, tech stack, design, planning, and implementation. Modes: full (interactive), auto (default), fast (skip research), parallel (multi-agent)."
|
|
4
4
|
license: MIT
|
|
5
5
|
argument-hint: "[requirements] [--full|--auto|--fast|--parallel]"
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: brainstorm
|
|
3
3
|
description: "Brainstorm solutions with trade-off analysis and brutal honesty. Use for ideation, architecture decisions, technical debates, feature exploration, feasibility assessment, design discussions."
|
|
4
4
|
license: MIT
|
|
5
5
|
version: 2.0.0
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: chrome-devtools
|
|
3
3
|
description: Automate browsers with Puppeteer CLI scripts and persistent sessions. Use for screenshots, performance analysis, network monitoring, web scraping, form automation, JavaScript debugging.
|
|
4
4
|
license: Apache-2.0
|
|
5
5
|
version: 1.1.0
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: code-review
|
|
3
3
|
description: "Review code quality, receive feedback with technical rigor, verify completion claims. Use before PRs, after implementing features, when claiming task completion. Includes scout-based edge case detection and native Task pipeline orchestration."
|
|
4
4
|
argument-hint: "[context] OR codebase [parallel]"
|
|
5
5
|
---
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: context-engineering
|
|
3
3
|
description: >-
|
|
4
4
|
Check context usage limits, monitor time remaining, optimize token consumption, debug context failures.
|
|
5
5
|
Use when asking about context percentage, rate limits, usage warnings, context optimization, agent architectures, memory systems.
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: copywriting
|
|
3
3
|
description: Conversion copywriting formulas, headline templates, email copy patterns, landing page structures, CTA optimization, and writing style extraction. Activate for writing high-converting copy, crafting headlines, email campaigns, landing pages, or applying custom writing styles from assets/writing-styles/ directory.
|
|
4
4
|
license: MIT
|
|
5
5
|
argument-hint: "[copy-type] [context]"
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: databases
|
|
3
3
|
description: Design schemas, write queries for MongoDB and PostgreSQL. Use for database design, SQL/NoSQL queries, aggregation pipelines, indexes, migrations, replication, performance optimization, psql CLI.
|
|
4
4
|
license: MIT
|
|
5
5
|
argument-hint: "[query or schema task]"
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: debug
|
|
3
3
|
description: "Debug systematically with root cause analysis before fixes. Use for bugs, test failures, unexpected behavior, performance issues, call stack tracing, multi-layer validation, log analysis, CI/CD failures, database diagnostics, system investigation."
|
|
4
4
|
version: 4.0.0
|
|
5
5
|
languages: all
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: docs-seeker
|
|
3
3
|
description: Search library/framework documentation via llms.txt (context7.com). Use for API docs, GitHub repository analysis, technical documentation lookup, latest library features.
|
|
4
4
|
version: 3.1.0
|
|
5
5
|
argument-hint: "[library-name] [topic]"
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: docx
|
|
3
3
|
description: Create, edit, analyze .docx Word documents. Use for document creation, tracked changes, comments, formatting preservation, text extraction, template modification.
|
|
4
4
|
license: Proprietary. LICENSE.txt has complete terms
|
|
5
5
|
---
|