cokit-cli 1.0.5 → 1.0.7
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/.vscode/settings.json +70 -0
- package/INIT.md +154 -0
- package/agents/git-manager.agent.md +1 -3
- package/instructions/ck-development.instructions.md +14 -0
- package/package.json +1 -1
- package/prompts/ck-bootstrap.prompt.md +8 -8
- package/prompts/ck-brainstorm.prompt.md +48 -11
- package/prompts/ck-code-auto.prompt.md +5 -4
- package/prompts/ck-code-no-test.prompt.md +3 -2
- package/prompts/ck-code-parallel.prompt.md +2 -1
- package/prompts/ck-code.prompt.md +2 -1
- package/prompts/ck-cook-auto-parallel.prompt.md +2 -1
- package/prompts/ck-cook-auto.prompt.md +5 -3
- package/prompts/ck-cook.prompt.md +7 -6
- package/prompts/ck-fix-hard.prompt.md +2 -2
- package/prompts/ck-git-merge.prompt.md +1 -1
- package/prompts/ck-plan-archive.prompt.md +8 -9
- package/prompts/ck-plan-ci.prompt.md +4 -3
- package/prompts/ck-plan-fast.prompt.md +38 -2
- package/prompts/ck-plan-hard.prompt.md +42 -6
- package/prompts/ck-plan-parallel.prompt.md +40 -7
- package/prompts/ck-plan-two.prompt.md +40 -5
- package/prompts/ck-plan-validate.prompt.md +4 -5
- package/prompts/ck-plan.prompt.md +80 -30
- package/prompts/ck-skill-add.prompt.md +5 -5
- package/prompts/ck-skill-create.prompt.md +5 -5
- package/prompts/ck-skill-fix-logs.prompt.md +2 -2
- package/prompts/ck-skill-optimize-auto.prompt.md +5 -5
- package/prompts/ck-skill-optimize.prompt.md +5 -5
- package/prompts/ck-skill-plan.prompt.md +7 -7
- package/prompts/ck-test-ui.prompt.md +1 -1
- package/prompts/ck-worktree.prompt.md +7 -7
- package/skills/ck-chrome-devtools/scripts/README.md +1 -1
- package/skills/ck-markdown-novel-viewer/scripts/server.cjs +1 -1
- package/skills/ck-payment-integration/README.md +1 -1
- package/skills/ck-repomix/references/usage-patterns.md +2 -2
- package/skills/ck-shopify/README.md +5 -5
- package/skills/ck-skill-creator/SKILL.md +12 -14
- package/templates/repo/.github/agents/brainstormer.agent.md +71 -0
- package/templates/repo/.github/agents/code-reviewer.agent.md +128 -0
- package/templates/repo/.github/agents/database-admin.agent.md +91 -0
- package/templates/repo/.github/agents/debugger.agent.md +128 -0
- package/templates/repo/.github/agents/docs-manager.agent.md +121 -0
- package/templates/repo/.github/agents/fullstack-developer.agent.md +96 -0
- package/templates/repo/.github/agents/git-manager.agent.md +390 -0
- package/templates/repo/.github/agents/mcp-manager.agent.md +93 -0
- package/templates/repo/.github/agents/planner.agent.md +94 -0
- package/templates/repo/.github/agents/project-manager.agent.md +124 -0
- package/templates/repo/.github/agents/researcher.agent.md +32 -0
- package/templates/repo/.github/agents/scout-external.agent.md +141 -0
- package/templates/repo/.github/agents/scout.agent.md +107 -0
- package/templates/repo/.github/agents/tester.agent.md +106 -0
- package/templates/repo/.github/agents/ui-ux-designer.agent.md +225 -0
- package/templates/repo/.github/collections/ck-core.collection.yml +30 -0
- package/templates/repo/.github/collections/ck-development-rules.collection.yml +18 -0
- package/templates/repo/.github/collections/ck-documentation.collection.yml +18 -0
- package/templates/repo/.github/collections/ck-git-workflow.collection.yml +18 -0
- package/templates/repo/.github/collections/ck-orchestration.collection.yml +22 -0
- package/templates/repo/.github/collections/ck-ui-design.collection.yml +18 -0
- package/templates/repo/.github/instructions/ck-development.instructions.md +14 -0
- package/templates/repo/.github/prompts/ck-bootstrap.prompt.md +8 -8
- package/templates/repo/.github/prompts/ck-brainstorm.prompt.md +48 -11
- package/templates/repo/.github/prompts/ck-code-auto.prompt.md +5 -4
- package/templates/repo/.github/prompts/ck-code-no-test.prompt.md +3 -2
- package/templates/repo/.github/prompts/ck-code-parallel.prompt.md +2 -1
- package/templates/repo/.github/prompts/ck-code.prompt.md +2 -1
- package/templates/repo/.github/prompts/ck-cook-auto-parallel.prompt.md +2 -1
- package/templates/repo/.github/prompts/ck-cook-auto.prompt.md +5 -3
- package/templates/repo/.github/prompts/ck-cook.prompt.md +7 -6
- package/templates/repo/.github/prompts/ck-fix-hard.prompt.md +2 -2
- package/templates/repo/.github/prompts/ck-git-merge.prompt.md +1 -1
- package/templates/repo/.github/prompts/ck-plan-archive.prompt.md +8 -9
- package/templates/repo/.github/prompts/ck-plan-ci.prompt.md +4 -3
- package/templates/repo/.github/prompts/ck-plan-fast.prompt.md +38 -2
- package/templates/repo/.github/prompts/ck-plan-hard.prompt.md +42 -6
- package/templates/repo/.github/prompts/ck-plan-parallel.prompt.md +40 -7
- package/templates/repo/.github/prompts/ck-plan-two.prompt.md +40 -5
- package/templates/repo/.github/prompts/ck-plan-validate.prompt.md +4 -5
- package/templates/repo/.github/prompts/ck-plan.prompt.md +80 -30
- package/templates/repo/.github/prompts/ck-skill-add.prompt.md +5 -5
- package/templates/repo/.github/prompts/ck-skill-create.prompt.md +5 -5
- package/templates/repo/.github/prompts/ck-skill-fix-logs.prompt.md +2 -2
- package/templates/repo/.github/prompts/ck-skill-optimize-auto.prompt.md +5 -5
- package/templates/repo/.github/prompts/ck-skill-optimize.prompt.md +5 -5
- package/templates/repo/.github/prompts/ck-skill-plan.prompt.md +7 -7
- package/templates/repo/.github/prompts/ck-test-ui.prompt.md +1 -1
- package/templates/repo/.github/prompts/ck-worktree.prompt.md +7 -7
- package/templates/repo/.github/skills/ck-chrome-devtools/scripts/README.md +1 -1
- package/templates/repo/.github/skills/ck-markdown-novel-viewer/scripts/server.cjs +1 -1
- package/templates/repo/.github/skills/ck-payment-integration/README.md +1 -1
- package/templates/repo/.github/skills/ck-repomix/references/usage-patterns.md +2 -2
- package/templates/repo/.github/skills/ck-shopify/README.md +5 -5
- package/templates/repo/.github/skills/ck-skill-creator/SKILL.md +12 -14
- package/templates/repo/.vscode/settings.json +66 -2
|
@@ -21,7 +21,7 @@ node info --json
|
|
|
21
21
|
- `envFiles`: array of .env* files found
|
|
22
22
|
- `dirtyState`: boolean
|
|
23
23
|
|
|
24
|
-
### Step 2: Gather Info
|
|
24
|
+
### Step 2: Gather Info
|
|
25
25
|
|
|
26
26
|
**Detect branch prefix from user's description:**
|
|
27
27
|
- Keywords "fix", "bug", "error", "issue" → prefix = `fix`
|
|
@@ -32,10 +32,10 @@ node info --json
|
|
|
32
32
|
- Keywords "perf", "performance", "optimize" → prefix = `perf`
|
|
33
33
|
- Everything else → prefix = `feat`
|
|
34
34
|
|
|
35
|
-
**For MONOREPO:**
|
|
35
|
+
**For MONOREPO:** Ask user if project not specified:
|
|
36
36
|
```javascript
|
|
37
37
|
// If user said "/worktree add auth" but multiple projects exist
|
|
38
|
-
|
|
38
|
+
// Ask user with questions like:
|
|
39
39
|
questions: [{
|
|
40
40
|
header: "Project",
|
|
41
41
|
question: "Which project should the worktree be created for?",
|
|
@@ -47,7 +47,7 @@ AskUserQuestion({
|
|
|
47
47
|
|
|
48
48
|
**For env files:** Always ask which to copy:
|
|
49
49
|
```javascript
|
|
50
|
-
|
|
50
|
+
// Ask user with questions like:
|
|
51
51
|
questions: [{
|
|
52
52
|
header: "Env files",
|
|
53
53
|
question: "Which environment files should be copied to the worktree?",
|
|
@@ -97,8 +97,8 @@ node create "<SLUG>" --prefix <TYPE> --env "<FILES>"
|
|
|
97
97
|
| `MISSING_ARGS` | Missing project/feature for monorepo | Ask for both |
|
|
98
98
|
| `MISSING_FEATURE` | No feature name (standalone) | Ask for feature |
|
|
99
99
|
| `PROJECT_NOT_FOUND` | Project not in .gitmodules | Show available projects |
|
|
100
|
-
| `MULTIPLE_PROJECTS_MATCH` | Ambiguous project name |
|
|
101
|
-
| `MULTIPLE_WORKTREES_MATCH` | Ambiguous worktree for remove |
|
|
100
|
+
| `MULTIPLE_PROJECTS_MATCH` | Ambiguous project name | Ask user |
|
|
101
|
+
| `MULTIPLE_WORKTREES_MATCH` | Ambiguous worktree for remove | Ask user |
|
|
102
102
|
| `BRANCH_CHECKED_OUT` | Branch in use elsewhere | Suggest different name |
|
|
103
103
|
| `WORKTREE_EXISTS` | Path already exists | Suggest use or remove |
|
|
104
104
|
| `WORKTREE_CREATE_FAILED` | Git command failed | Show git error |
|
|
@@ -114,7 +114,7 @@ Claude: [Runs: node info --json]
|
|
|
114
114
|
[Detects prefix from "fix" keyword: fix]
|
|
115
115
|
[Converts slug: "login-validation-bug"]
|
|
116
116
|
|
|
117
|
-
Claude: [
|
|
117
|
+
Claude: [Asks user for env files]
|
|
118
118
|
"Which environment files should be copied?"
|
|
119
119
|
Options: .env.example
|
|
120
120
|
|
|
@@ -110,7 +110,7 @@ Take a screenshot with automatic compression.
|
|
|
110
110
|
node screenshot.js --output screenshot.png [--url https://example.com] [--full-page true] [--selector .element] [--max-size 5] [--no-compress]
|
|
111
111
|
```
|
|
112
112
|
|
|
113
|
-
**Automatic Compression**: Screenshots >5MB are automatically compressed using ImageMagick to ensure compatibility with Gemini API and
|
|
113
|
+
**Automatic Compression**: Screenshots >5MB are automatically compressed using ImageMagick to ensure compatibility with Gemini API and AI assistants. Install ImageMagick for this feature:
|
|
114
114
|
- macOS: `brew install imagemagick`
|
|
115
115
|
- Linux: `sudo apt-get install imagemagick`
|
|
116
116
|
|
|
@@ -289,7 +289,7 @@ async function main() {
|
|
|
289
289
|
}
|
|
290
290
|
|
|
291
291
|
// Background mode - spawn child and exit (legacy mode for manual runs)
|
|
292
|
-
// Skip if --foreground is set (for
|
|
292
|
+
// Skip if --foreground is set (for AI assistant background tasks)
|
|
293
293
|
if (args.background && !args.foreground && !args.isChild) {
|
|
294
294
|
const childArgs = ['--port', String(args.port), '--host', args.host, '--child'];
|
|
295
295
|
if (resolved.type === 'file') {
|
|
@@ -58,7 +58,7 @@ payment-integration/
|
|
|
58
58
|
|
|
59
59
|
### Activate the Skill
|
|
60
60
|
|
|
61
|
-
|
|
61
|
+
GitHub Copilot will automatically activate this skill when you mention payment integration, subscriptions, webhooks, or platform-specific terms (SePay, Polar).
|
|
62
62
|
|
|
63
63
|
### Manual Activation
|
|
64
64
|
|
|
@@ -144,9 +144,9 @@ repomix --include "$(cat staged-files.txt | tr '\n' ',')" -o .context/latest.xml
|
|
|
144
144
|
{"version": "2.0.0", "tasks": [{"label": "Package for AI", "type": "shell", "command": "repomix --include 'src/**' --remove-comments --copy"}]}
|
|
145
145
|
```
|
|
146
146
|
|
|
147
|
-
###
|
|
147
|
+
### GitHub Copilot
|
|
148
148
|
```bash
|
|
149
|
-
repomix --style markdown --copy # Then paste into
|
|
149
|
+
repomix --style markdown --copy # Then paste into GitHub Copilot
|
|
150
150
|
```
|
|
151
151
|
|
|
152
152
|
## Language-Specific Patterns
|
|
@@ -5,9 +5,9 @@ This directory contains comprehensive research and analysis of various APIs for
|
|
|
5
5
|
## Contents
|
|
6
6
|
|
|
7
7
|
### Shopify GraphQL Admin API Analysis
|
|
8
|
-
**File:** `shopify-graphql-admin-api-analysis.md`
|
|
9
|
-
**Date:** 2025-10-25
|
|
10
|
-
**Status:** Complete
|
|
8
|
+
**File:** `shopify-graphql-admin-api-analysis.md`
|
|
9
|
+
**Date:** 2025-10-25
|
|
10
|
+
**Status:** Complete
|
|
11
11
|
**Thoroughness:** Very Thorough
|
|
12
12
|
|
|
13
13
|
A comprehensive analysis of Shopify's GraphQL Admin API covering:
|
|
@@ -62,5 +62,5 @@ These documents are intended for:
|
|
|
62
62
|
|
|
63
63
|
---
|
|
64
64
|
|
|
65
|
-
**Last Updated:** 2025-10-25
|
|
66
|
-
**Maintained By:**
|
|
65
|
+
**Last Updated:** 2025-10-25
|
|
66
|
+
**Maintained By:** CoKit Contributors
|
|
@@ -15,9 +15,9 @@ domains or tasks—they transform Claude from a general-purpose agent into a spe
|
|
|
15
15
|
equipped with procedural knowledge that no model can fully possess.
|
|
16
16
|
|
|
17
17
|
**IMPORTANT:**
|
|
18
|
-
- Skills are not documentation, they are practical instructions for
|
|
19
|
-
- Each skill teaches
|
|
20
|
-
-
|
|
18
|
+
- Skills are not documentation, they are practical instructions for GitHub Copilot to use the tools, packages, plugins or APIs to achieve the tasks.
|
|
19
|
+
- Each skill teaches GitHub Copilot how to perform a specific development task, not what a tool does.
|
|
20
|
+
- GitHub Copilot can activate multiple skills automatically to achieve the user's request.
|
|
21
21
|
|
|
22
22
|
### What Skills Provide
|
|
23
23
|
|
|
@@ -51,14 +51,14 @@ Every skill consists of a required SKILL.md file and optional bundled resources:
|
|
|
51
51
|
- Skill should be combined into specific topics, for example: `cloudflare`, `cloudflare-r2`, `cloudflare-workers`, `docker`, `gcloud` should be combined into `devops`
|
|
52
52
|
- `SKILL.md` should be **less than 100 lines** and include the references of related markdown files and scripts.
|
|
53
53
|
- Each script or referenced markdown file should be also **less than 100 lines**, remember that you can always split them into multiple files (**progressive disclosure** principle).
|
|
54
|
-
- Descriptions in metadata of `SKILL.md` files should be both concise and still contains enough usecases of the references and scripts, this will help skills can be activated automatically during the implementation process of
|
|
54
|
+
- Descriptions in metadata of `SKILL.md` files should be both concise and still contains enough usecases of the references and scripts, this will help skills can be activated automatically during the implementation process of GitHub Copilot.
|
|
55
55
|
- **Referenced markdowns**:
|
|
56
56
|
- Sacrifice grammar for the sake of concision when writing these files.
|
|
57
57
|
- Can reference other markdown files or scripts as well.
|
|
58
58
|
- **Referenced scripts**:
|
|
59
59
|
- Prefer nodejs or python scripts instead of bash script, because bash scripts are not well-supported on Windows.
|
|
60
60
|
- If you're going to write python scripts, make sure you have `requirements.txt`
|
|
61
|
-
- Make sure scripts respect `.env` file follow this order: `process.env` > > >
|
|
61
|
+
- Make sure scripts respect `.env` file follow this order: `process.env` > > >
|
|
62
62
|
- Create `.env.example` files to show the required environment variables.
|
|
63
63
|
- Always write tests for these scripts.
|
|
64
64
|
|
|
@@ -69,7 +69,7 @@ Every skill consists of a required SKILL.md file and optional bundled resources:
|
|
|
69
69
|
- Referenced scripts: no limit on length, just make sure it works, no compile issues, no runtime issues, no dependencies issues, no environment issues, no platform issues.
|
|
70
70
|
|
|
71
71
|
**Why?**
|
|
72
|
-
Better **context engineering**: leverage **progressive disclosure** technique of Agent Skills, when agent skills are activated,
|
|
72
|
+
Better **context engineering**: leverage **progressive disclosure** technique of Agent Skills, when agent skills are activated, GitHub Copilot will consider to load only relevant files into the context, instead of reading all long `SKILL.md` as before.
|
|
73
73
|
|
|
74
74
|
#### SKILL.md (required)
|
|
75
75
|
|
|
@@ -94,7 +94,7 @@ Executable code (Python/Bash/etc.) for tasks that require deterministic reliabil
|
|
|
94
94
|
- Write tests for scripts.
|
|
95
95
|
- Run tests and make sure it works, if tests fail, fix them and run tests again, repeat until tests pass.
|
|
96
96
|
- Run scripts manually with some usecases to make sure it works.
|
|
97
|
-
- Make sure scripts respect `.env` file follow this order: `process.env` > > >
|
|
97
|
+
- Make sure scripts respect `.env` file follow this order: `process.env` > > >
|
|
98
98
|
|
|
99
99
|
##### References (`references/`)
|
|
100
100
|
|
|
@@ -109,8 +109,8 @@ Documentation and reference material intended to be loaded as needed into contex
|
|
|
109
109
|
|
|
110
110
|
**IMPORTANT:**
|
|
111
111
|
- Referenced markdown files should be also **less than 100 lines**, remember that you can always split them into multiple files (**progressive disclosure** principle).
|
|
112
|
-
- Referenced markdown files are practical instructions for
|
|
113
|
-
- Each skill teaches
|
|
112
|
+
- Referenced markdown files are practical instructions for GitHub Copilot to use the tools, packages, plugins or APIs to achieve the tasks.
|
|
113
|
+
- Each skill teaches GitHub Copilot how to perform a specific development task, not what a tool does.
|
|
114
114
|
|
|
115
115
|
##### Assets (`assets/`)
|
|
116
116
|
|
|
@@ -176,7 +176,7 @@ Example: When building a `big-query` skill to handle queries like "How many user
|
|
|
176
176
|
|
|
177
177
|
To establish the skill's contents, analyze each concrete example to create a list of the reusable resources to include: scripts, references, and assets.
|
|
178
178
|
|
|
179
|
-
- Make sure scripts respect `.env` file follow this order: `process.env` > > >
|
|
179
|
+
- Make sure scripts respect `.env` file follow this order: `process.env` > > >
|
|
180
180
|
- Make sure scripts have tests.
|
|
181
181
|
|
|
182
182
|
### Step 3: Initializing the Skill
|
|
@@ -259,7 +259,5 @@ After testing the skill, users may request improvements. Often this happens righ
|
|
|
259
259
|
4. Implement changes and test again
|
|
260
260
|
|
|
261
261
|
## References
|
|
262
|
-
- [Agent Skills](https://
|
|
263
|
-
- [
|
|
264
|
-
- [Agent Skills Overview](https://docs.claude.com/en/docs/agents-and-tools/agent-skills/overview.md)
|
|
265
|
-
- [Best Practices](https://docs.claude.com/en/docs/agents-and-tools/agent-skills/best-practices.md)
|
|
262
|
+
- [Agent Skills Spec](https://github.com/anthropics/awesome-claude-prompts/blob/main/CONTRIBUTING.md)
|
|
263
|
+
- [GitHub Copilot Documentation](https://docs.github.com/en/copilot)
|
|
@@ -1,6 +1,70 @@
|
|
|
1
1
|
{
|
|
2
|
-
"
|
|
2
|
+
"// GitHub Copilot Settings": "",
|
|
3
3
|
"github.copilot.enable": {
|
|
4
|
-
"*": true
|
|
4
|
+
"*": true,
|
|
5
|
+
"markdown": true,
|
|
6
|
+
"yaml": true,
|
|
7
|
+
"plaintext": true
|
|
8
|
+
},
|
|
9
|
+
"// Editor Settings": "",
|
|
10
|
+
"editor.formatOnSave": true,
|
|
11
|
+
"editor.codeActionsOnSave": {
|
|
12
|
+
"source.fixAll": "explicit",
|
|
13
|
+
"source.organizeImports": "explicit"
|
|
14
|
+
},
|
|
15
|
+
"editor.inlineSuggest.enabled": true,
|
|
16
|
+
"editor.quickSuggestions": {
|
|
17
|
+
"other": true,
|
|
18
|
+
"comments": true,
|
|
19
|
+
"strings": true
|
|
20
|
+
},
|
|
21
|
+
"editor.tabSize": 2,
|
|
22
|
+
"editor.insertSpaces": true,
|
|
23
|
+
"editor.detectIndentation": true,
|
|
24
|
+
"editor.wordWrap": "on",
|
|
25
|
+
"// Files Settings": "",
|
|
26
|
+
"files.autoSave": "onFocusChange",
|
|
27
|
+
"files.trimTrailingWhitespace": true,
|
|
28
|
+
"files.insertFinalNewline": true,
|
|
29
|
+
"files.encoding": "utf8",
|
|
30
|
+
"files.eol": "\n",
|
|
31
|
+
"// Terminal Settings": "",
|
|
32
|
+
"terminal.integrated.defaultProfile.windows": "PowerShell",
|
|
33
|
+
"terminal.integrated.enablePersistentSessions": true,
|
|
34
|
+
"terminal.integrated.cursorBlinking": true,
|
|
35
|
+
"// Search Settings": "",
|
|
36
|
+
"search.exclude": {
|
|
37
|
+
"**/node_modules": true,
|
|
38
|
+
"**/dist": true,
|
|
39
|
+
"**/build": true,
|
|
40
|
+
"**/out": true,
|
|
41
|
+
"**/.git": true,
|
|
42
|
+
"**/package-lock.json": true
|
|
43
|
+
},
|
|
44
|
+
"// Markdown Settings": "",
|
|
45
|
+
"markdown.preview.breaks": true,
|
|
46
|
+
"markdown.preview.linkify": true,
|
|
47
|
+
"// Git Settings": "",
|
|
48
|
+
"git.autofetch": true,
|
|
49
|
+
"git.confirmSync": false,
|
|
50
|
+
"git.enableSmartCommit": true,
|
|
51
|
+
"// Formatting": "",
|
|
52
|
+
"[markdown]": {
|
|
53
|
+
"editor.defaultFormatter": "esbenp.prettier-vscode",
|
|
54
|
+
"editor.wordWrap": "on",
|
|
55
|
+
"editor.quickSuggestions": {
|
|
56
|
+
"comments": true,
|
|
57
|
+
"strings": true,
|
|
58
|
+
"other": true
|
|
59
|
+
}
|
|
60
|
+
},
|
|
61
|
+
"[javascript]": {
|
|
62
|
+
"editor.defaultFormatter": "esbenp.prettier-vscode"
|
|
63
|
+
},
|
|
64
|
+
"[json]": {
|
|
65
|
+
"editor.defaultFormatter": "esbenp.prettier-vscode"
|
|
66
|
+
},
|
|
67
|
+
"[yaml]": {
|
|
68
|
+
"editor.defaultFormatter": "esbenp.prettier-vscode"
|
|
5
69
|
}
|
|
6
70
|
}
|