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.
Files changed (137) hide show
  1. package/package.json +1 -1
  2. package/templates/command-archive/ask.md +56 -0
  3. package/templates/command-archive/ck-help.md +129 -0
  4. package/templates/command-archive/coding-level.md +48 -0
  5. package/templates/command-archive/docs/init.md +38 -0
  6. package/templates/command-archive/docs/summarize.md +22 -0
  7. package/templates/command-archive/docs/update.md +76 -0
  8. package/templates/command-archive/journal.md +18 -0
  9. package/templates/command-archive/kanban.md +99 -0
  10. package/templates/command-archive/plan/archive.md +57 -0
  11. package/templates/command-archive/plan/red-team.md +200 -0
  12. package/templates/command-archive/plan/validate.md +188 -0
  13. package/templates/command-archive/preview.md +283 -0
  14. package/templates/command-archive/review/codebase/parallel.md +122 -0
  15. package/templates/command-archive/review/codebase.md +49 -0
  16. package/templates/command-archive/test/ui.md +92 -0
  17. package/templates/command-archive/test.md +8 -0
  18. package/templates/command-archive/use-mcp.md +38 -0
  19. package/templates/command-archive/watzup.md +8 -0
  20. package/templates/command-archive/worktree.md +109 -0
  21. package/templates/hooks/.logs/hook-log.jsonl +31 -0
  22. package/templates/settings.local.json +13 -0
  23. package/templates/skills/agent-browser/SKILL.md +1 -1
  24. package/templates/skills/ai-artist/SKILL.md +1 -1
  25. package/templates/skills/ai-multimodal/SKILL.md +1 -1
  26. package/templates/skills/ask/SKILL.md +1 -1
  27. package/templates/skills/backend-development/SKILL.md +1 -1
  28. package/templates/skills/better-auth/SKILL.md +1 -1
  29. package/templates/skills/bootstrap/SKILL.md +1 -1
  30. package/templates/skills/brainstorm/SKILL.md +1 -1
  31. package/templates/skills/chrome-devtools/SKILL.md +1 -1
  32. package/templates/skills/ck-help/SKILL.md +1 -1
  33. package/templates/skills/code-review/SKILL.md +1 -1
  34. package/templates/skills/coding-level/SKILL.md +1 -1
  35. package/templates/skills/context-engineering/SKILL.md +1 -1
  36. package/templates/skills/cook/SKILL.md +1 -1
  37. package/templates/skills/copywriting/SKILL.md +1 -1
  38. package/templates/skills/databases/SKILL.md +1 -1
  39. package/templates/skills/debug/SKILL.md +1 -1
  40. package/templates/skills/devops/SKILL.md +1 -1
  41. package/templates/skills/docs/SKILL.md +1 -1
  42. package/templates/skills/docs-seeker/SKILL.md +1 -1
  43. package/templates/skills/document-skills/docx/SKILL.md +1 -1
  44. package/templates/skills/document-skills/pdf/SKILL.md +1 -1
  45. package/templates/skills/document-skills/pptx/SKILL.md +1 -1
  46. package/templates/skills/document-skills/xlsx/SKILL.md +1 -1
  47. package/templates/skills/find-skills/SKILL.md +1 -1
  48. package/templates/skills/fix/SKILL.md +1 -1
  49. package/templates/skills/frontend-design/SKILL.md +1 -1
  50. package/templates/skills/frontend-development/SKILL.md +1 -1
  51. package/templates/skills/git/SKILL.md +1 -1
  52. package/templates/skills/gkg/SKILL.md +1 -1
  53. package/templates/skills/google-adk-python/SKILL.md +1 -1
  54. package/templates/skills/journal/SKILL.md +1 -1
  55. package/templates/skills/kanban/SKILL.md +1 -1
  56. package/templates/skills/markdown-novel-viewer/SKILL.md +1 -1
  57. package/templates/skills/mcp-builder/SKILL.md +1 -1
  58. package/templates/skills/mcp-management/SKILL.md +1 -1
  59. package/templates/skills/media-processing/SKILL.md +1 -1
  60. package/templates/skills/mermaidjs-v11/SKILL.md +1 -1
  61. package/templates/skills/mintlify/SKILL.md +1 -1
  62. package/templates/skills/mobile-development/SKILL.md +1 -1
  63. package/templates/skills/payment-integration/SKILL.md +1 -1
  64. package/templates/skills/plan/SKILL.md +1 -1
  65. package/templates/skills/plans-kanban/SKILL.md +1 -1
  66. package/templates/skills/preview/SKILL.md +1 -1
  67. package/templates/skills/problem-solving/SKILL.md +1 -1
  68. package/templates/skills/project-management/SKILL.md +1 -1
  69. package/templates/skills/react-best-practices/SKILL.md +1 -1
  70. package/templates/skills/remotion/SKILL.md +1 -1
  71. package/templates/skills/repomix/SKILL.md +1 -1
  72. package/templates/skills/research/SKILL.md +1 -1
  73. package/templates/skills/scout/SKILL.md +1 -1
  74. package/templates/skills/sequential-thinking/SKILL.md +1 -1
  75. package/templates/skills/shader/SKILL.md +1 -1
  76. package/templates/skills/shopify/SKILL.md +1 -1
  77. package/templates/skills/skill-creator/SKILL.md +1 -1
  78. package/templates/skills/tanstack/SKILL.md +1 -1
  79. package/templates/skills/team/SKILL.md +1 -1
  80. package/templates/skills/template-skill/SKILL.md +1 -1
  81. package/templates/skills/test/SKILL.md +1 -1
  82. package/templates/skills/threejs/SKILL.md +1 -1
  83. package/templates/skills/ui-styling/SKILL.md +1 -1
  84. package/templates/skills/ui-ux-pro-max/SKILL.md +1 -1
  85. package/templates/skills/use-mcp/SKILL.md +1 -1
  86. package/templates/skills/watzup/SKILL.md +1 -1
  87. package/templates/skills/web-design-guidelines/SKILL.md +1 -1
  88. package/templates/skills/web-frameworks/SKILL.md +2 -2
  89. package/templates/skills/web-testing/SKILL.md +1 -1
  90. package/templates/skills/worktree/SKILL.md +1 -1
  91. package/templates/commands/bootstrap/auto/fast.md +0 -111
  92. package/templates/commands/bootstrap/auto/parallel.md +0 -66
  93. package/templates/commands/bootstrap/auto.md +0 -115
  94. package/templates/commands/bootstrap.md +0 -137
  95. package/templates/commands/code/auto.md +0 -203
  96. package/templates/commands/code/no-test.md +0 -174
  97. package/templates/commands/code/parallel.md +0 -100
  98. package/templates/commands/code.md +0 -205
  99. package/templates/commands/content/cro.md +0 -43
  100. package/templates/commands/content/enhance.md +0 -14
  101. package/templates/commands/content/fast.md +0 -13
  102. package/templates/commands/content/good.md +0 -16
  103. package/templates/commands/cook/auto/fast.md +0 -26
  104. package/templates/commands/cook/auto/parallel.md +0 -49
  105. package/templates/commands/cook/auto.md +0 -15
  106. package/templates/commands/cook.md +0 -105
  107. package/templates/commands/debug.md +0 -13
  108. package/templates/commands/design/3d.md +0 -83
  109. package/templates/commands/design/describe.md +0 -23
  110. package/templates/commands/design/fast.md +0 -31
  111. package/templates/commands/design/good.md +0 -35
  112. package/templates/commands/design/screenshot.md +0 -34
  113. package/templates/commands/design/video.md +0 -34
  114. package/templates/commands/fix/ci.md +0 -17
  115. package/templates/commands/fix/fast.md +0 -19
  116. package/templates/commands/fix/hard.md +0 -39
  117. package/templates/commands/fix/logs.md +0 -26
  118. package/templates/commands/fix/parallel.md +0 -54
  119. package/templates/commands/fix/test.md +0 -20
  120. package/templates/commands/fix/types.md +0 -9
  121. package/templates/commands/fix/ui.md +0 -48
  122. package/templates/commands/fix.md +0 -43
  123. package/templates/commands/plan/ci.md +0 -33
  124. package/templates/commands/plan/cro.md +0 -69
  125. package/templates/commands/plan/fast.md +0 -82
  126. package/templates/commands/plan/hard.md +0 -108
  127. package/templates/commands/plan/parallel.md +0 -145
  128. package/templates/commands/plan/two.md +0 -45
  129. package/templates/commands/plan.md +0 -30
  130. package/templates/commands/scout/ext.md +0 -39
  131. package/templates/commands/scout.md +0 -28
  132. package/templates/commands/skill/add.md +0 -36
  133. package/templates/commands/skill/create.md +0 -29
  134. package/templates/commands/skill/fix-logs.md +0 -22
  135. package/templates/commands/skill/optimize/auto.md +0 -25
  136. package/templates/commands/skill/optimize.md +0 -34
  137. 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":""}
@@ -0,0 +1,13 @@
1
+ {
2
+ "permissions": {
3
+ "allow": [
4
+ "Bash(cat:*)",
5
+ "Bash(ls:*)",
6
+ "Bash(test:*)",
7
+ "Bash(chmod:*)",
8
+ "Bash(./install.sh)",
9
+ "Bash(.venv/bin/pip install:*)",
10
+ "Bash(grep:*)"
11
+ ]
12
+ }
13
+ }
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: ck:agent-browser
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: ck:ai-artist
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: ck:ai-multimodal
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: ck:ask
2
+ name: ask
3
3
  description: "Answer technical and architectural questions with expert consultation."
4
4
  argument-hint: "[technical-question]"
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: ck:backend-development
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: ck:better-auth
2
+ name: better-auth
3
3
  description: Add authentication with Better Auth (TypeScript). Use for email/password, OAuth providers (Google, GitHub), 2FA/MFA, passkeys/WebAuthn, sessions, RBAC, rate limiting.
4
4
  license: MIT
5
5
  version: 2.0.0
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: ck:bootstrap
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: ck:brainstorm
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: ck:chrome-devtools
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: ck:ck-help
2
+ name: ck-help
3
3
  description: "ClaudeKit usage guide — discover commands, skills, workflows naturally."
4
4
  argument-hint: "[category|command|task description]"
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: ck:code-review
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: ck:coding-level
2
+ name: coding-level
3
3
  description: "Set coding experience level for tailored explanations and output format."
4
4
  argument-hint: "[0-5]"
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: ck:context-engineering
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: ck:cook
2
+ name: cook
3
3
  description: "ALWAYS activate this skill before implementing EVERY feature, plan, or fix."
4
4
  version: 2.1.1
5
5
  argument-hint: "[task|plan-path] [--interactive|--fast|--parallel|--auto|--no-test]"
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: ck:copywriting
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: ck:databases
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: ck:debug
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: ck:devops
2
+ name: devops
3
3
  description: Deploy to Cloudflare (Workers, R2, D1), Docker, GCP (Cloud Run, GKE), Kubernetes (kubectl, Helm). Use for serverless, containers, CI/CD, GitOps, security audit.
4
4
  license: MIT
5
5
  version: 2.0.0
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: ck:docs
2
+ name: docs
3
3
  description: "Analyze codebase and manage project documentation — init, update, summarize."
4
4
  argument-hint: "init|update|summarize"
5
5
  ---
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: ck:docs-seeker
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: ck:docx
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
  ---