@ckelsoe/prompt-architect 3.0.2 → 3.1.1

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 (76) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/CHANGELOG.md +264 -264
  4. package/LICENSE +21 -21
  5. package/README.md +1064 -1184
  6. package/adapters/README.md +75 -267
  7. package/adapters/for-windsurf.md +136 -136
  8. package/adapters/system-prompt.md +243 -243
  9. package/package.json +139 -138
  10. package/scripts/build-skill.js +64 -0
  11. package/scripts/install.js +4 -54
  12. package/scripts/test.js +205 -213
  13. package/scripts/validate-skill.js +350 -350
  14. package/skills/prompt-architect/SKILL.md +331 -331
  15. package/skills/prompt-architect/assets/templates/ape_template.txt +5 -5
  16. package/skills/prompt-architect/assets/templates/bab_template.txt +15 -15
  17. package/skills/prompt-architect/assets/templates/broke_template.txt +15 -15
  18. package/skills/prompt-architect/assets/templates/cai-critique-revise_template.txt +18 -18
  19. package/skills/prompt-architect/assets/templates/care_template.txt +16 -16
  20. package/skills/prompt-architect/assets/templates/chain-of-density_template.txt +46 -46
  21. package/skills/prompt-architect/assets/templates/chain-of-thought_template.txt +49 -49
  22. package/skills/prompt-architect/assets/templates/co-star_template.txt +17 -17
  23. package/skills/prompt-architect/assets/templates/crispe_template.txt +14 -14
  24. package/skills/prompt-architect/assets/templates/ctf_template.txt +15 -15
  25. package/skills/prompt-architect/assets/templates/devils-advocate_template.txt +25 -25
  26. package/skills/prompt-architect/assets/templates/hybrid_template.txt +101 -101
  27. package/skills/prompt-architect/assets/templates/least-to-most_template.txt +16 -16
  28. package/skills/prompt-architect/assets/templates/plan-and-solve_template.txt +7 -7
  29. package/skills/prompt-architect/assets/templates/pre-mortem_template.txt +27 -27
  30. package/skills/prompt-architect/assets/templates/race_template.txt +19 -19
  31. package/skills/prompt-architect/assets/templates/rcot_template.txt +31 -31
  32. package/skills/prompt-architect/assets/templates/react_template.txt +27 -27
  33. package/skills/prompt-architect/assets/templates/reverse-role_template.txt +11 -11
  34. package/skills/prompt-architect/assets/templates/rise-ie_template.txt +23 -23
  35. package/skills/prompt-architect/assets/templates/rise-ix_template.txt +28 -28
  36. package/skills/prompt-architect/assets/templates/risen_template.txt +21 -21
  37. package/skills/prompt-architect/assets/templates/rpef_template.txt +26 -26
  38. package/skills/prompt-architect/assets/templates/rtf_template.txt +13 -13
  39. package/skills/prompt-architect/assets/templates/self-refine_template.txt +16 -16
  40. package/skills/prompt-architect/assets/templates/skeleton-of-thought_template.txt +15 -15
  41. package/skills/prompt-architect/assets/templates/step-back_template.txt +10 -10
  42. package/skills/prompt-architect/assets/templates/tidd-ec_template.txt +45 -45
  43. package/skills/prompt-architect/assets/templates/tree-of-thought_template.txt +30 -30
  44. package/skills/prompt-architect/references/frameworks/ape.md +200 -200
  45. package/skills/prompt-architect/references/frameworks/bab.md +242 -242
  46. package/skills/prompt-architect/references/frameworks/broke.md +242 -242
  47. package/skills/prompt-architect/references/frameworks/cai-critique-revise.md +230 -230
  48. package/skills/prompt-architect/references/frameworks/care.md +235 -235
  49. package/skills/prompt-architect/references/frameworks/chain-of-density.md +479 -479
  50. package/skills/prompt-architect/references/frameworks/chain-of-thought.md +424 -424
  51. package/skills/prompt-architect/references/frameworks/co-star.md +256 -256
  52. package/skills/prompt-architect/references/frameworks/crispe.md +253 -253
  53. package/skills/prompt-architect/references/frameworks/ctf.md +207 -207
  54. package/skills/prompt-architect/references/frameworks/devils-advocate.md +206 -206
  55. package/skills/prompt-architect/references/frameworks/least-to-most.md +226 -226
  56. package/skills/prompt-architect/references/frameworks/plan-and-solve.md +210 -210
  57. package/skills/prompt-architect/references/frameworks/pre-mortem.md +197 -197
  58. package/skills/prompt-architect/references/frameworks/race.md +243 -243
  59. package/skills/prompt-architect/references/frameworks/rcot.md +203 -203
  60. package/skills/prompt-architect/references/frameworks/react.md +304 -304
  61. package/skills/prompt-architect/references/frameworks/reverse-role.md +189 -189
  62. package/skills/prompt-architect/references/frameworks/rise.md +555 -555
  63. package/skills/prompt-architect/references/frameworks/risen.md +297 -297
  64. package/skills/prompt-architect/references/frameworks/rpef.md +195 -195
  65. package/skills/prompt-architect/references/frameworks/rtf.md +358 -358
  66. package/skills/prompt-architect/references/frameworks/self-refine.md +205 -205
  67. package/skills/prompt-architect/references/frameworks/skeleton-of-thought.md +186 -186
  68. package/skills/prompt-architect/references/frameworks/step-back.md +206 -206
  69. package/skills/prompt-architect/references/frameworks/tidd-ec.md +470 -470
  70. package/skills/prompt-architect/references/frameworks/tree-of-thought.md +260 -260
  71. package/skills/prompt-architect/scripts/framework_analyzer.py +807 -807
  72. package/skills/prompt-architect/scripts/prompt_evaluator.py +336 -336
  73. package/adapters/for-cursor.mdc +0 -138
  74. package/adapters/for-gemini-cli.md +0 -70
  75. package/adapters/for-github-copilot.md +0 -141
  76. package/adapters/for-openai-codex-cli.md +0 -158
package/package.json CHANGED
@@ -1,138 +1,139 @@
1
- {
2
- "name": "@ckelsoe/prompt-architect",
3
- "version": "3.0.2",
4
- "description": "Agent skill for analyzing and improving prompts using 27 research-backed frameworks across 7 intent categories. Works with Claude Code, Gemini CLI, Cursor, Copilot, and 30+ Agent Skills compatible tools.",
5
- "main": "skills/prompt-architect/SKILL.md",
6
- "keywords": [
7
- "claude-code",
8
- "claude-skill",
9
- "agent-skills",
10
- "gemini-cli",
11
- "prompt-engineering",
12
- "prompt-improvement",
13
- "prompt-frameworks",
14
- "co-star",
15
- "risen",
16
- "rise",
17
- "tidd-ec",
18
- "rtf",
19
- "ctf",
20
- "ape",
21
- "bab",
22
- "race",
23
- "crispe",
24
- "broke",
25
- "care",
26
- "chain-of-thought",
27
- "chain-of-density",
28
- "skeleton-of-thought",
29
- "step-back-prompting",
30
- "least-to-most",
31
- "plan-and-solve",
32
- "tree-of-thought",
33
- "react-prompting",
34
- "self-refine",
35
- "devils-advocate",
36
- "pre-mortem",
37
- "reverse-prompt-engineering",
38
- "ai-prompts",
39
- "llm-prompts",
40
- "prompt-optimization",
41
- "ai-engineering",
42
- "llm-engineering",
43
- "prompt-architect"
44
- ],
45
- "author": "Charles Kelsoe <charles@kelsoe.com>",
46
- "license": "MIT",
47
- "repository": {
48
- "type": "git",
49
- "url": "https://github.com/ckelsoe/prompt-architect.git"
50
- },
51
- "bugs": {
52
- "url": "https://github.com/ckelsoe/prompt-architect/issues"
53
- },
54
- "homepage": "https://github.com/ckelsoe/prompt-architect#readme",
55
- "bin": {
56
- "prompt-architect": "scripts/install.js"
57
- },
58
- "engines": {
59
- "node": ">=14.0.0"
60
- },
61
- "files": [
62
- "skills/",
63
- ".claude-plugin/",
64
- "adapters/",
65
- "scripts/",
66
- "README.md",
67
- "LICENSE",
68
- "CHANGELOG.md",
69
- "MIGRATION.md"
70
- ],
71
- "scripts": {
72
- "test": "node scripts/test.js",
73
- "validate": "node scripts/validate-skill.js",
74
- "install-user": "node scripts/install.js",
75
- "install-project": "node scripts/install.js --project",
76
- "postinstall": "node scripts/install.js",
77
- "prepublishOnly": "npm run validate"
78
- },
79
- "claudeCode": {
80
- "type": "skill",
81
- "skillName": "prompt-architect",
82
- "skillPath": "skills/prompt-architect",
83
- "version": "3.0.2",
84
- "compatibility": {
85
- "claudeCode": ">=1.0.0"
86
- },
87
- "intentCategories": [
88
- "recover",
89
- "clarify",
90
- "create",
91
- "transform",
92
- "reason",
93
- "critique",
94
- "agentic"
95
- ],
96
- "frameworks": [
97
- "CO-STAR",
98
- "RISEN",
99
- "RISE-IE",
100
- "RISE-IX",
101
- "TIDD-EC",
102
- "CTF",
103
- "RTF",
104
- "APE",
105
- "BAB",
106
- "RACE",
107
- "CRISPE",
108
- "BROKE",
109
- "CARE",
110
- "Skeleton-of-Thought",
111
- "Step-Back",
112
- "Least-to-Most",
113
- "Plan-and-Solve",
114
- "Tree-of-Thought",
115
- "ReAct",
116
- "Chain-of-Thought",
117
- "Chain-of-Density",
118
- "Self-Refine",
119
- "CAI-Critique-Revise",
120
- "Devils-Advocate",
121
- "Pre-Mortem",
122
- "RCoT",
123
- "RPEF",
124
- "Reverse-Role-Prompting"
125
- ],
126
- "features": {
127
- "promptAnalysis": true,
128
- "intentBasedSelection": true,
129
- "frameworkRecommendation": true,
130
- "iterativeRefinement": true,
131
- "qualityScoring": true,
132
- "frameworkCombinations": true
133
- }
134
- },
135
- "dependencies": {
136
- "@clack/prompts": "^1.1.0"
137
- }
138
- }
1
+ {
2
+ "name": "@ckelsoe/prompt-architect",
3
+ "version": "3.1.1",
4
+ "description": "Agent skill for analyzing and improving prompts using 27 research-backed frameworks across 7 intent categories. Works with Claude Code, Gemini CLI, Cursor, Copilot, and 30+ Agent Skills compatible tools.",
5
+ "main": "skills/prompt-architect/SKILL.md",
6
+ "keywords": [
7
+ "claude-code",
8
+ "claude-skill",
9
+ "agent-skills",
10
+ "gemini-cli",
11
+ "prompt-engineering",
12
+ "prompt-improvement",
13
+ "prompt-frameworks",
14
+ "co-star",
15
+ "risen",
16
+ "rise",
17
+ "tidd-ec",
18
+ "rtf",
19
+ "ctf",
20
+ "ape",
21
+ "bab",
22
+ "race",
23
+ "crispe",
24
+ "broke",
25
+ "care",
26
+ "chain-of-thought",
27
+ "chain-of-density",
28
+ "skeleton-of-thought",
29
+ "step-back-prompting",
30
+ "least-to-most",
31
+ "plan-and-solve",
32
+ "tree-of-thought",
33
+ "react-prompting",
34
+ "self-refine",
35
+ "devils-advocate",
36
+ "pre-mortem",
37
+ "reverse-prompt-engineering",
38
+ "ai-prompts",
39
+ "llm-prompts",
40
+ "prompt-optimization",
41
+ "ai-engineering",
42
+ "llm-engineering",
43
+ "prompt-architect"
44
+ ],
45
+ "author": "Charles Kelsoe <charles@kelsoe.com>",
46
+ "license": "MIT",
47
+ "repository": {
48
+ "type": "git",
49
+ "url": "https://github.com/ckelsoe/prompt-architect.git"
50
+ },
51
+ "bugs": {
52
+ "url": "https://github.com/ckelsoe/prompt-architect/issues"
53
+ },
54
+ "homepage": "https://github.com/ckelsoe/prompt-architect#readme",
55
+ "bin": {
56
+ "prompt-architect": "scripts/install.js"
57
+ },
58
+ "engines": {
59
+ "node": ">=14.0.0"
60
+ },
61
+ "files": [
62
+ "skills/",
63
+ ".claude-plugin/",
64
+ "adapters/",
65
+ "scripts/",
66
+ "README.md",
67
+ "LICENSE",
68
+ "CHANGELOG.md",
69
+ "MIGRATION.md"
70
+ ],
71
+ "scripts": {
72
+ "test": "node scripts/test.js",
73
+ "validate": "node scripts/validate-skill.js",
74
+ "install-user": "node scripts/install.js",
75
+ "install-project": "node scripts/install.js --project",
76
+ "postinstall": "node scripts/install.js",
77
+ "build:skill": "node scripts/build-skill.js",
78
+ "prepublishOnly": "npm run validate"
79
+ },
80
+ "claudeCode": {
81
+ "type": "skill",
82
+ "skillName": "prompt-architect",
83
+ "skillPath": "skills/prompt-architect",
84
+ "version": "3.1.1",
85
+ "compatibility": {
86
+ "claudeCode": ">=1.0.0"
87
+ },
88
+ "intentCategories": [
89
+ "recover",
90
+ "clarify",
91
+ "create",
92
+ "transform",
93
+ "reason",
94
+ "critique",
95
+ "agentic"
96
+ ],
97
+ "frameworks": [
98
+ "CO-STAR",
99
+ "RISEN",
100
+ "RISE-IE",
101
+ "RISE-IX",
102
+ "TIDD-EC",
103
+ "CTF",
104
+ "RTF",
105
+ "APE",
106
+ "BAB",
107
+ "RACE",
108
+ "CRISPE",
109
+ "BROKE",
110
+ "CARE",
111
+ "Skeleton-of-Thought",
112
+ "Step-Back",
113
+ "Least-to-Most",
114
+ "Plan-and-Solve",
115
+ "Tree-of-Thought",
116
+ "ReAct",
117
+ "Chain-of-Thought",
118
+ "Chain-of-Density",
119
+ "Self-Refine",
120
+ "CAI-Critique-Revise",
121
+ "Devils-Advocate",
122
+ "Pre-Mortem",
123
+ "RCoT",
124
+ "RPEF",
125
+ "Reverse-Role-Prompting"
126
+ ],
127
+ "features": {
128
+ "promptAnalysis": true,
129
+ "intentBasedSelection": true,
130
+ "frameworkRecommendation": true,
131
+ "iterativeRefinement": true,
132
+ "qualityScoring": true,
133
+ "frameworkCombinations": true
134
+ }
135
+ },
136
+ "dependencies": {
137
+ "@clack/prompts": "^1.1.0"
138
+ }
139
+ }
@@ -0,0 +1,64 @@
1
+ #!/usr/bin/env node
2
+
3
+ /**
4
+ * Build .skill file (zip archive of the skill directory)
5
+ *
6
+ * Creates prompt-architect.skill in the repo root — a zip of
7
+ * skills/prompt-architect/ that can be uploaded to ChatGPT,
8
+ * Gemini CLI, or any Agent Skills compatible tool.
9
+ *
10
+ * Usage:
11
+ * node scripts/build-skill.js
12
+ */
13
+
14
+ const fs = require('fs');
15
+ const path = require('path');
16
+ const { execSync } = require('child_process');
17
+
18
+ const SKILL_DIR = path.join(__dirname, '..', 'skills', 'prompt-architect');
19
+ const OUTPUT_FILE = path.join(__dirname, '..', 'prompt-architect.skill');
20
+
21
+ if (!fs.existsSync(SKILL_DIR)) {
22
+ console.error('Error: skills/prompt-architect/ not found');
23
+ process.exit(1);
24
+ }
25
+
26
+ // Remove old .skill file if exists
27
+ if (fs.existsSync(OUTPUT_FILE)) {
28
+ fs.unlinkSync(OUTPUT_FILE);
29
+ }
30
+
31
+ // Use tar on all platforms (available in Git Bash on Windows, native on macOS/Linux)
32
+ // Create a zip using Node.js built-in zlib won't work for directories,
33
+ // so we use the platform's zip/tar command.
34
+ try {
35
+ const skillsRoot = path.join(__dirname, '..', 'skills');
36
+
37
+ if (process.platform === 'win32') {
38
+ // PowerShell's Compress-Archive via child process
39
+ execSync(
40
+ `powershell -NoProfile -Command "Compress-Archive -Path '${SKILL_DIR}\\*' -DestinationPath '${OUTPUT_FILE}.zip' -Force"`,
41
+ { stdio: 'inherit' }
42
+ );
43
+ // Rename .zip to .skill
44
+ fs.renameSync(OUTPUT_FILE + '.zip', OUTPUT_FILE);
45
+ } else {
46
+ // Unix: use zip command from the skills/ directory
47
+ execSync(
48
+ `cd "${skillsRoot}" && zip -r "${OUTPUT_FILE}" prompt-architect/`,
49
+ { stdio: 'inherit' }
50
+ );
51
+ }
52
+
53
+ const stats = fs.statSync(OUTPUT_FILE);
54
+ const sizeKB = (stats.size / 1024).toFixed(1);
55
+ console.log(`\n Built: prompt-architect.skill (${sizeKB} KB)\n`);
56
+ console.log(' Upload this file to:');
57
+ console.log(' - ChatGPT: Profile → Skills → New skill → Upload');
58
+ console.log(' - Gemini CLI: gemini skills install ./prompt-architect.skill');
59
+ console.log(' - Any Agent Skills compatible tool\n');
60
+
61
+ } catch (err) {
62
+ console.error(`Build failed: ${err.message}`);
63
+ process.exit(1);
64
+ }
@@ -59,36 +59,6 @@ const AGENTS = [
59
59
  format: 'skill',
60
60
  hint: () => '~/.agents/skills/ (30+ compatible agents)',
61
61
  },
62
- {
63
- id: 'cursor',
64
- name: 'Cursor',
65
- detect: () => {
66
- return fs.existsSync(path.join(os.homedir(), '.cursor')) ||
67
- fs.existsSync(path.join(process.cwd(), '.cursor'));
68
- },
69
- installPath: () => path.join(process.cwd(), '.cursor', 'rules', 'prompt-architect.mdc'),
70
- format: 'adapter',
71
- adapterFile: 'for-cursor.mdc',
72
- hint: () => '.cursor/rules/ (project)',
73
- },
74
- {
75
- id: 'copilot',
76
- name: 'GitHub Copilot',
77
- detect: () => {
78
- try {
79
- execSync(process.platform === 'win32' ? 'where code' : 'which code', { stdio: 'ignore' });
80
- return true;
81
- } catch {
82
- return fs.existsSync(path.join(process.cwd(), '.vscode')) ||
83
- fs.existsSync(path.join(process.cwd(), '.github'));
84
- }
85
- },
86
- installPath: () => path.join(process.cwd(), '.github', 'copilot-instructions.md'),
87
- format: 'adapter',
88
- adapterFile: 'for-github-copilot.md',
89
- appendMode: true,
90
- hint: () => '.github/copilot-instructions.md (project)',
91
- },
92
62
  {
93
63
  id: 'windsurf',
94
64
  name: 'Windsurf',
@@ -102,23 +72,6 @@ const AGENTS = [
102
72
  appendMode: true,
103
73
  hint: () => '.windsurfrules (project)',
104
74
  },
105
- {
106
- id: 'codex',
107
- name: 'OpenAI Codex CLI',
108
- detect: () => {
109
- try {
110
- execSync(process.platform === 'win32' ? 'where codex' : 'which codex', { stdio: 'ignore' });
111
- return true;
112
- } catch {
113
- return fs.existsSync(path.join(process.cwd(), 'AGENTS.md'));
114
- }
115
- },
116
- installPath: () => path.join(process.cwd(), 'AGENTS.md'),
117
- format: 'adapter',
118
- adapterFile: 'for-openai-codex-cli.md',
119
- appendMode: true,
120
- hint: () => 'AGENTS.md (project)',
121
- },
122
75
  ];
123
76
 
124
77
  // ─── Source Path Resolution ──────────────────────────────────────
@@ -241,13 +194,10 @@ function parseArgs() {
241
194
  claude: args.includes('--claude'),
242
195
  gemini: args.includes('--gemini'),
243
196
  agents: args.includes('--agents'),
244
- cursor: args.includes('--cursor'),
245
- copilot: args.includes('--copilot'),
246
197
  windsurf: args.includes('--windsurf'),
247
- codex: args.includes('--codex'),
248
198
  };
249
199
 
250
- const specificAgents = ['claude', 'gemini', 'agents', 'cursor', 'copilot', 'windsurf', 'codex']
200
+ const specificAgents = ['claude', 'gemini', 'agents', 'windsurf']
251
201
  .filter(a => flags[a]);
252
202
 
253
203
  return { flags, specificAgents };
@@ -269,10 +219,10 @@ function showHelp() {
269
219
  --claude Claude Code (~/.claude/skills/)
270
220
  --gemini Gemini CLI (~/.gemini/skills/)
271
221
  --agents Agent Skills universal (~/.agents/skills/)
272
- --cursor Cursor (.cursor/rules/)
273
- --copilot GitHub Copilot (.github/)
274
222
  --windsurf Windsurf (.windsurfrules)
275
- --codex OpenAI Codex CLI (AGENTS.md)
223
+
224
+ Note: Cursor, Copilot, Codex, and 30+ other tools use the Agent Skills
225
+ standard. Install with --agents to cover all of them.
276
226
 
277
227
  Options:
278
228
  -a, --all Install to all detected agents