@ckelsoe/prompt-architect 3.0.0

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 +20 -0
  2. package/.claude-plugin/plugin.json +18 -0
  3. package/CHANGELOG.md +264 -0
  4. package/LICENSE +21 -0
  5. package/MIGRATION.md +66 -0
  6. package/README.md +1184 -0
  7. package/adapters/README.md +267 -0
  8. package/adapters/for-cursor.mdc +138 -0
  9. package/adapters/for-gemini-cli.md +70 -0
  10. package/adapters/for-github-copilot.md +141 -0
  11. package/adapters/for-openai-codex-cli.md +158 -0
  12. package/adapters/for-windsurf.md +136 -0
  13. package/adapters/system-prompt.md +243 -0
  14. package/package.json +135 -0
  15. package/scripts/install.js +490 -0
  16. package/scripts/test.js +213 -0
  17. package/scripts/validate-skill.js +350 -0
  18. package/skills/prompt-architect/SKILL.md +331 -0
  19. package/skills/prompt-architect/assets/templates/ape_template.txt +5 -0
  20. package/skills/prompt-architect/assets/templates/bab_template.txt +15 -0
  21. package/skills/prompt-architect/assets/templates/broke_template.txt +15 -0
  22. package/skills/prompt-architect/assets/templates/cai-critique-revise_template.txt +18 -0
  23. package/skills/prompt-architect/assets/templates/care_template.txt +16 -0
  24. package/skills/prompt-architect/assets/templates/chain-of-density_template.txt +46 -0
  25. package/skills/prompt-architect/assets/templates/chain-of-thought_template.txt +49 -0
  26. package/skills/prompt-architect/assets/templates/co-star_template.txt +17 -0
  27. package/skills/prompt-architect/assets/templates/crispe_template.txt +14 -0
  28. package/skills/prompt-architect/assets/templates/ctf_template.txt +15 -0
  29. package/skills/prompt-architect/assets/templates/devils-advocate_template.txt +25 -0
  30. package/skills/prompt-architect/assets/templates/hybrid_template.txt +101 -0
  31. package/skills/prompt-architect/assets/templates/least-to-most_template.txt +16 -0
  32. package/skills/prompt-architect/assets/templates/plan-and-solve_template.txt +7 -0
  33. package/skills/prompt-architect/assets/templates/pre-mortem_template.txt +27 -0
  34. package/skills/prompt-architect/assets/templates/race_template.txt +19 -0
  35. package/skills/prompt-architect/assets/templates/rcot_template.txt +31 -0
  36. package/skills/prompt-architect/assets/templates/react_template.txt +27 -0
  37. package/skills/prompt-architect/assets/templates/reverse-role_template.txt +11 -0
  38. package/skills/prompt-architect/assets/templates/rise-ie_template.txt +23 -0
  39. package/skills/prompt-architect/assets/templates/rise-ix_template.txt +28 -0
  40. package/skills/prompt-architect/assets/templates/risen_template.txt +21 -0
  41. package/skills/prompt-architect/assets/templates/rpef_template.txt +26 -0
  42. package/skills/prompt-architect/assets/templates/rtf_template.txt +13 -0
  43. package/skills/prompt-architect/assets/templates/self-refine_template.txt +16 -0
  44. package/skills/prompt-architect/assets/templates/skeleton-of-thought_template.txt +15 -0
  45. package/skills/prompt-architect/assets/templates/step-back_template.txt +10 -0
  46. package/skills/prompt-architect/assets/templates/tidd-ec_template.txt +45 -0
  47. package/skills/prompt-architect/assets/templates/tree-of-thought_template.txt +30 -0
  48. package/skills/prompt-architect/references/frameworks/ape.md +200 -0
  49. package/skills/prompt-architect/references/frameworks/bab.md +242 -0
  50. package/skills/prompt-architect/references/frameworks/broke.md +242 -0
  51. package/skills/prompt-architect/references/frameworks/cai-critique-revise.md +230 -0
  52. package/skills/prompt-architect/references/frameworks/care.md +235 -0
  53. package/skills/prompt-architect/references/frameworks/chain-of-density.md +479 -0
  54. package/skills/prompt-architect/references/frameworks/chain-of-thought.md +424 -0
  55. package/skills/prompt-architect/references/frameworks/co-star.md +256 -0
  56. package/skills/prompt-architect/references/frameworks/crispe.md +253 -0
  57. package/skills/prompt-architect/references/frameworks/ctf.md +207 -0
  58. package/skills/prompt-architect/references/frameworks/devils-advocate.md +206 -0
  59. package/skills/prompt-architect/references/frameworks/least-to-most.md +226 -0
  60. package/skills/prompt-architect/references/frameworks/plan-and-solve.md +210 -0
  61. package/skills/prompt-architect/references/frameworks/pre-mortem.md +197 -0
  62. package/skills/prompt-architect/references/frameworks/race.md +243 -0
  63. package/skills/prompt-architect/references/frameworks/rcot.md +203 -0
  64. package/skills/prompt-architect/references/frameworks/react.md +304 -0
  65. package/skills/prompt-architect/references/frameworks/reverse-role.md +189 -0
  66. package/skills/prompt-architect/references/frameworks/rise.md +555 -0
  67. package/skills/prompt-architect/references/frameworks/risen.md +297 -0
  68. package/skills/prompt-architect/references/frameworks/rpef.md +195 -0
  69. package/skills/prompt-architect/references/frameworks/rtf.md +358 -0
  70. package/skills/prompt-architect/references/frameworks/self-refine.md +205 -0
  71. package/skills/prompt-architect/references/frameworks/skeleton-of-thought.md +186 -0
  72. package/skills/prompt-architect/references/frameworks/step-back.md +206 -0
  73. package/skills/prompt-architect/references/frameworks/tidd-ec.md +470 -0
  74. package/skills/prompt-architect/references/frameworks/tree-of-thought.md +260 -0
  75. package/skills/prompt-architect/scripts/framework_analyzer.py +807 -0
  76. package/skills/prompt-architect/scripts/prompt_evaluator.py +336 -0
@@ -0,0 +1,267 @@
1
+ # Prompt Architect — Cross-Platform Adapters
2
+
3
+ This folder contains ready-to-use versions of the Prompt Architect skill for AI tools beyond those that natively support the [Agent Skills standard](https://agentskills.io).
4
+
5
+ Tools that support Agent Skills (Claude Code, Gemini CLI, Cursor, Copilot, and 30+ others) can use the native `skills/prompt-architect/SKILL.md` directly. The adapters here are for tools that need a reformatted version.
6
+
7
+ ---
8
+
9
+ ## Why adapters exist
10
+
11
+ The `skills/prompt-architect/SKILL.md` file follows the [Agent Skills standard](https://agentskills.io) — an open format supported by 30+ AI tools. Tools like Claude Code and Gemini CLI can discover and load SKILL.md natively.
12
+
13
+ For tools that don't support Agent Skills natively, the adapters solve two problems:
14
+ - The YAML frontmatter is removed (some tools render it as raw text)
15
+ - File-loading references are replaced with self-contained instructions
16
+ - Each adapter is formatted exactly as the target tool expects
17
+
18
+ **The framework knowledge (all 27 frameworks, intent categories, clarification questions) is identical across all adapters.** Only the packaging changes.
19
+
20
+ ---
21
+
22
+ ## What "installing" means for each tool
23
+
24
+ | Tool | Where instructions go | Auto-discovered? | How to activate |
25
+ |------|----------------------|------------------|-----------------|
26
+ | **Claude Code** | `~/.claude/skills/` or `/plugin install` | ✅ Yes — automatic | Ask Claude to improve a prompt |
27
+ | **Gemini CLI** | `~/.gemini/skills/` or `gemini skills install` | ✅ Yes — native Agent Skills | Ask Gemini to improve a prompt |
28
+ | **Agent Skills (30+ tools)** | `~/.agents/skills/` | ✅ Yes — universal path | Ask the agent to improve a prompt |
29
+ | **OpenAI Codex CLI** | `AGENTS.md` in your project root | ✅ Yes — read per session | Ask Codex to improve a prompt |
30
+ | **Cursor** | `.cursor/rules/prompt-architect.mdc` | ✅ Yes — loaded automatically | Ask Cursor to improve a prompt |
31
+ | **GitHub Copilot** | `.github/copilot-instructions.md` | ✅ Yes — loaded per workspace | Ask Copilot to improve a prompt |
32
+ | **Windsurf** | `.windsurfrules` in your project root | ✅ Yes — read per session | Ask Windsurf to improve a prompt |
33
+ | **Any LLM API / ChatGPT / custom** | Paste into system prompt field | Manual | Call the API / open the chat |
34
+
35
+ ---
36
+
37
+ ## Adapter files in this folder
38
+
39
+ | File | Use with | What to do with it |
40
+ |------|----------|--------------------|
41
+ | `system-prompt.md` | Any LLM (API, ChatGPT, Gemini, etc.) | Paste contents into the system prompt field |
42
+ | `for-gemini-cli.md` | Gemini CLI | Installation guide (native SKILL.md works directly) |
43
+ | `for-openai-codex-cli.md` | OpenAI Codex CLI | Copy contents into `AGENTS.md` in your project root |
44
+ | `for-cursor.mdc` | Cursor editor | Copy file to `.cursor/rules/prompt-architect.mdc` |
45
+ | `for-github-copilot.md` | GitHub Copilot | Copy contents into `.github/copilot-instructions.md` |
46
+ | `for-windsurf.md` | Windsurf editor | Copy contents into `.windsurfrules` in your project root |
47
+
48
+ ---
49
+
50
+ ## Limitations vs. Claude Code
51
+
52
+ Claude Code's version has one capability the adapters cannot replicate:
53
+
54
+ > **On-demand reference loading**: When Claude Code applies a framework, it can load the detailed 600-800 line reference doc for that specific framework (e.g., `references/frameworks/co-star.md`). This gives it richer examples and selection criteria.
55
+
56
+ The adapters work from:
57
+ 1. The full intent-based selection system (all 7 categories, all 27 frameworks)
58
+ 2. The complete clarification question sets
59
+ 3. The LLM's training knowledge of each framework
60
+
61
+ For most use cases, this is equivalent. The reference docs add depth for edge cases and complex applications.
62
+
63
+ ---
64
+
65
+ ## Installation instructions by tool
66
+
67
+ ### Claude Code (Plugin System)
68
+
69
+ Claude Code now supports plugins with a marketplace. You can install directly:
70
+
71
+ ```shell
72
+ # Option A: Add the marketplace and install
73
+ /plugin marketplace add ckelsoe/prompt-architect
74
+ /plugin install prompt-architect@prompt-architect-marketplace
75
+
76
+ # Option B: Load directly for testing
77
+ claude --plugin-dir /path/to/prompt-architect
78
+ ```
79
+
80
+ The legacy `npm install -g` method also still works — the interactive installer will set up `~/.claude/skills/`.
81
+
82
+ ---
83
+
84
+ ### Gemini CLI
85
+
86
+ Gemini CLI natively supports Agent Skills — the `SKILL.md` works directly, no adapter needed.
87
+
88
+ ```bash
89
+ # Option A: Install from GitHub
90
+ gemini skills install https://github.com/ckelsoe/prompt-architect.git
91
+
92
+ # Option B: Manual copy
93
+ cp -r skills/prompt-architect/ ~/.gemini/skills/prompt-architect/
94
+
95
+ # Option C: After npm install
96
+ gemini skills link "$(npm root -g)/@ckelsoe/prompt-architect/skills/prompt-architect"
97
+ ```
98
+
99
+ See `adapters/for-gemini-cli.md` for full details.
100
+
101
+ ---
102
+
103
+ ### OpenAI Codex CLI
104
+
105
+ **What is AGENTS.md?**
106
+ The Codex CLI reads `AGENTS.md` from your project root at the start of each session. It's the Codex equivalent of Claude Code's `CLAUDE.md` — project-level instructions that shape how the AI behaves.
107
+
108
+ **Steps:**
109
+ ```bash
110
+ # Option A: Create a new AGENTS.md with just this skill
111
+ cp /path/to/adapters/for-openai-codex-cli.md ./AGENTS.md
112
+
113
+ # Option B: Append to an existing AGENTS.md
114
+ cat /path/to/adapters/for-openai-codex-cli.md >> ./AGENTS.md
115
+
116
+ # Option C: After npm install
117
+ cat node_modules/@ckelsoe/prompt-architect/adapters/for-openai-codex-cli.md >> ./AGENTS.md
118
+ ```
119
+
120
+ **Verify it's working:**
121
+ ```
122
+ codex "Help me improve this prompt: write a blog post"
123
+ ```
124
+ You should see intent detection, framework recommendation, and clarifying questions.
125
+
126
+ ---
127
+
128
+ ### Cursor
129
+
130
+ **What is .cursor/rules/?**
131
+ Cursor loads `.mdc` files from `.cursor/rules/` in your project. Each file can apply always or only for specific file patterns. The `prompt-architect.mdc` adapter uses `alwaysApply: false` so it only activates when you ask for prompt help — it won't interfere with normal coding.
132
+
133
+ **Steps:**
134
+ ```bash
135
+ # Create the rules directory if it doesn't exist
136
+ mkdir -p .cursor/rules
137
+
138
+ # Copy the adapter
139
+ cp /path/to/adapters/for-cursor.mdc .cursor/rules/prompt-architect.mdc
140
+
141
+ # Or after npm install
142
+ cp node_modules/@ckelsoe/prompt-architect/adapters/for-cursor.mdc .cursor/rules/prompt-architect.mdc
143
+ ```
144
+
145
+ **Verify it's working:**
146
+ Open Cursor, ask: `"Help me improve this prompt: write a blog post"`
147
+
148
+ **Note:** Cursor will load this rule when the description matches the context of your request. If it doesn't activate automatically, you can reference it directly: `"Using the prompt-architect rules, help me improve..."`
149
+
150
+ ---
151
+
152
+ ### GitHub Copilot
153
+
154
+ **What is copilot-instructions.md?**
155
+ GitHub Copilot reads `.github/copilot-instructions.md` from your repository root. These instructions apply to all Copilot interactions in that workspace — in VS Code, Visual Studio, JetBrains, etc.
156
+
157
+ **Important**: This file applies to ALL Copilot interactions in the repo, not just prompt engineering tasks. If you have other instructions there already, append rather than overwrite.
158
+
159
+ **Steps:**
160
+ ```bash
161
+ # Create the .github directory if needed
162
+ mkdir -p .github
163
+
164
+ # Option A: New file
165
+ cp /path/to/adapters/for-github-copilot.md .github/copilot-instructions.md
166
+
167
+ # Option B: Append to existing
168
+ cat /path/to/adapters/for-github-copilot.md >> .github/copilot-instructions.md
169
+
170
+ # Or after npm install
171
+ cat node_modules/@ckelsoe/prompt-architect/adapters/for-github-copilot.md >> .github/copilot-instructions.md
172
+ ```
173
+
174
+ **Verify it's working:**
175
+ In a Copilot chat window, ask: `"Help me improve this prompt: write a blog post"`
176
+
177
+ ---
178
+
179
+ ### Windsurf
180
+
181
+ **What is .windsurfrules?**
182
+ Windsurf reads `.windsurfrules` from your project root. It works the same way as Cursor's rules but uses a simpler flat-file format instead of the `.mdc` directory structure.
183
+
184
+ **Steps:**
185
+ ```bash
186
+ # Option A: New file
187
+ cp /path/to/adapters/for-windsurf.md ./.windsurfrules
188
+
189
+ # Option B: Append to existing .windsurfrules
190
+ cat /path/to/adapters/for-windsurf.md >> ./.windsurfrules
191
+
192
+ # Or after npm install
193
+ cat node_modules/@ckelsoe/prompt-architect/adapters/for-windsurf.md >> ./.windsurfrules
194
+ ```
195
+
196
+ **Verify it's working:**
197
+ Ask Windsurf: `"Help me improve this prompt: write a blog post"`
198
+
199
+ ---
200
+
201
+ ### Any LLM API or Chat Interface (Universal)
202
+
203
+ Use `system-prompt.md` as your system prompt. This works with:
204
+ - OpenAI API (`gpt-4o`, `o1`, etc.)
205
+ - Anthropic API (when not using Claude Code)
206
+ - Google Gemini API
207
+ - ChatGPT (paste into a Custom GPT's "Instructions" field)
208
+ - Any chat interface that has a system prompt or custom instructions field
209
+
210
+ **For ChatGPT Custom GPT:**
211
+ 1. Go to [chat.openai.com](https://chat.openai.com) → Explore GPTs → Create a GPT
212
+ 2. Click "Configure"
213
+ 3. Copy the entire contents of `system-prompt.md`
214
+ 4. Paste into the "Instructions" field
215
+ 5. Name it "Prompt Architect"
216
+ 6. Save and publish (or keep private)
217
+
218
+ **For direct API use:**
219
+ ```python
220
+ import openai
221
+
222
+ with open("adapters/system-prompt.md", "r") as f:
223
+ system_prompt = f.read()
224
+
225
+ response = openai.chat.completions.create(
226
+ model="gpt-4o",
227
+ messages=[
228
+ {"role": "system", "content": system_prompt},
229
+ {"role": "user", "content": "Help me improve this prompt: write a blog post"}
230
+ ]
231
+ )
232
+ ```
233
+
234
+ ---
235
+
236
+ ## After npm install — quick reference
237
+
238
+ If you installed via `npm install -g @ckelsoe/prompt-architect`, the adapters are at:
239
+
240
+ ```
241
+ # Find your npm global prefix
242
+ npm prefix -g
243
+
244
+ # Adapters are at:
245
+ $(npm prefix -g)/lib/node_modules/@ckelsoe/prompt-architect/adapters/
246
+ ```
247
+
248
+ Or find them directly:
249
+ ```bash
250
+ ls $(npm root -g)/@ckelsoe/prompt-architect/adapters/
251
+ ```
252
+
253
+ ---
254
+
255
+ ## Troubleshooting
256
+
257
+ **The AI isn't using the framework system — it's just answering directly.**
258
+ → Try explicitly triggering it: `"Use the Prompt Architect framework to improve this prompt: [your prompt]"`
259
+
260
+ **The AI says it can't load the reference files.**
261
+ → This is expected. The adapters work from built-in knowledge, not the files in `references/frameworks/`. This is not an error — just a difference from the Claude Code version.
262
+
263
+ **The instructions are too long and getting truncated.**
264
+ → Use the Claude Code version instead, which handles large reference docs via progressive loading. Alternatively, use only the `system-prompt.md` content and ask the AI to focus on a subset of frameworks.
265
+
266
+ **Copilot is applying prompt engineering to all my code requests, not just when I ask.**
267
+ → The Copilot adapter uses trigger language to activate only when you ask about prompts. If it's too aggressive, add a line at the top of the instructions: `"Only apply prompt engineering guidance when the user explicitly asks for help with a prompt."`
@@ -0,0 +1,138 @@
1
+ ---
2
+ description: Prompt engineering expert using 27 research-backed frameworks. Activates when asked to improve, write, fix, or engineer a prompt. Uses intent-based framework selection (create, transform, reason, critique, recover, clarify, agentic) to recommend the right approach, ask targeted questions, and deliver a structured result.
3
+ alwaysApply: false
4
+ ---
5
+
6
+ ## How to install this file
7
+
8
+ Copy this file to `.cursor/rules/prompt-architect.mdc` in your project.
9
+
10
+ ```bash
11
+ mkdir -p .cursor/rules
12
+ cp node_modules/@ckelsoe/claude-skill-prompt-architect/adapters/for-cursor.mdc .cursor/rules/prompt-architect.mdc
13
+ ```
14
+
15
+ Cursor loads rules from `.cursor/rules/` automatically. Because `alwaysApply: false`, this rule activates based on the description above — it won't interfere with normal coding tasks.
16
+
17
+ ---
18
+
19
+ # Prompt Architect
20
+
21
+ You are an expert in prompt engineering and systematic application of prompting frameworks. When the user asks you to improve, write, fix, or engineer a prompt — or when a prompt they give you seems vague or incomplete — activate this skill.
22
+
23
+ ## Core Process
24
+
25
+ ### 1. Initial Assessment
26
+
27
+ Analyze the prompt across:
28
+ - **Clarity**: Is the goal clear?
29
+ - **Specificity**: Are requirements detailed?
30
+ - **Context**: Is background provided?
31
+ - **Constraints**: Are limitations specified?
32
+ - **Output Format**: Is the format clear?
33
+
34
+ ### 2. Intent-Based Framework Selection
35
+
36
+ Identify **primary intent** first, then discriminate within the category.
37
+
38
+ **A. RECOVER** → **RPEF**
39
+ *"I have an output but need/lost the prompt"*
40
+
41
+ **B. CLARIFY** → **Reverse Role Prompting**
42
+ *"I know roughly what I want but struggle to specify it"*
43
+
44
+ **C. CREATE** — New content from scratch
45
+
46
+ | Signal | Framework |
47
+ |--------|-----------|
48
+ | Ultra-minimal, one-off | **APE** |
49
+ | Simple, expertise-driven | **RTF** |
50
+ | Simple, context-driven | **CTF** |
51
+ | Role + context + outcome | **RACE** |
52
+ | Multiple variants needed | **CRISPE** |
53
+ | Business deliverable with KPIs | **BROKE** |
54
+ | Explicit rules/constraints | **CARE** or **TIDD-EC** |
55
+ | Audience, tone, style critical | **CO-STAR** |
56
+ | Multi-step procedure | **RISEN** |
57
+ | Data transformation | **RISE-IE** |
58
+ | Content with reference examples | **RISE-IX** |
59
+
60
+ *TIDD-EC: separate Do/Don't lists. CARE: combined rules + examples.*
61
+
62
+ **D. TRANSFORM** — Improving existing content
63
+
64
+ | Signal | Framework |
65
+ |--------|-----------|
66
+ | Rewrite / refactor / convert | **BAB** |
67
+ | Iterative quality improvement | **Self-Refine** |
68
+ | Compress or densify | **Chain of Density** |
69
+ | Outline-first then expand | **Skeleton of Thought** |
70
+
71
+ **E. REASON** — Reasoning or calculation
72
+
73
+ | Signal | Framework |
74
+ |--------|-----------|
75
+ | Numerical / zero-shot | **Plan-and-Solve (PS+)** |
76
+ | Multi-hop with dependencies | **Least-to-Most** |
77
+ | First-principles needed | **Step-Back** |
78
+ | Multiple approaches to compare | **Tree of Thought** |
79
+ | Verify conditions weren't missed | **RCoT** |
80
+ | Linear step-by-step | **Chain of Thought** |
81
+
82
+ **F. CRITIQUE** — Stress-testing or verifying
83
+
84
+ | Signal | Framework |
85
+ |--------|-----------|
86
+ | General quality improvement | **Self-Refine** |
87
+ | Align to principle/standard | **CAI Critique-Revise** |
88
+ | Strongest opposing argument | **Devil's Advocate** |
89
+ | Find failure modes | **Pre-Mortem** |
90
+ | Verify reasoning conditions | **RCoT** |
91
+
92
+ **G. AGENTIC** → **ReAct**
93
+ *"Task requires tools; each result informs the next step"*
94
+
95
+ ### 3. Clarification Questions (3-5 at a time)
96
+
97
+ **CO-STAR**: Context, audience, tone, style, objective, format?
98
+ **RISEN**: Role, principles, steps, success criteria, constraints?
99
+ **RISE-IE**: Role, input format, processing steps, output expectations?
100
+ **RISE-IX**: Role, task instructions, workflow steps, reference examples?
101
+ **TIDD-EC**: Task type, exact steps, dos, don'ts, examples, context?
102
+ **CTF**: Situation/background, exact task, output format?
103
+ **RTF**: Expertise needed, exact task, output format?
104
+ **APE**: Core action, why it's needed, what success looks like?
105
+ **BAB**: Current state/problem, desired state, transformation rules?
106
+ **RACE**: Role/expertise, action, situational context, expectation?
107
+ **CRISPE**: Capacity/role, insight, instructions, personality, how many variants?
108
+ **BROKE**: Background, role, objective, measurable key results, evolve?
109
+ **CARE**: Context, specific ask, rules/constraints, examples of good output?
110
+ **Tree of Thought**: Problem, 2-5 branches to explore, evaluation criteria?
111
+ **ReAct**: Goal, available tools, stop condition?
112
+ **Skeleton of Thought**: Topic, number of skeleton points, expansion depth?
113
+ **Step-Back**: Original question, higher-level principle governing it?
114
+ **Least-to-Most**: Full problem, ordered subproblems?
115
+ **Plan-and-Solve**: Problem with all numbers/variables?
116
+ **Chain of Thought**: Problem, reasoning steps, verification?
117
+ **Chain of Density**: Content, iterations, optimization goal?
118
+ **Self-Refine**: Output to improve, feedback dimensions, stop condition?
119
+ **CAI Critique-Revise**: The principle, output to critique?
120
+ **Devil's Advocate**: Position to attack, dimensions, rank severity?
121
+ **Pre-Mortem**: Project/decision, time horizon, domains to analyze?
122
+ **RCoT**: Question with all conditions, initial answer to verify?
123
+ **RPEF**: Output to reverse-engineer, input data if available?
124
+ **Reverse Role**: Intent, domain of expertise, batch or conversational?
125
+
126
+ ### 4. Apply & Present
127
+
128
+ 1. Apply the selected framework structure
129
+ 2. Show a clear before/after comparison
130
+ 3. Explain what changed and why
131
+ 4. Ask if this aligns with intent
132
+ 5. Iterate based on feedback
133
+
134
+ ## When NOT to Use Frameworks
135
+
136
+ Skip when the prompt is already complete, it's a factual lookup, casual chat, or the user says "just do it".
137
+
138
+ **Rule of thumb**: Framework when there's a gap between what was asked and what's needed.
@@ -0,0 +1,70 @@
1
+ # Prompt Architect — Gemini CLI
2
+
3
+ > **Gemini CLI natively supports the Agent Skills standard.** This means the `SKILL.md` in `skills/prompt-architect/` works directly — no adapter reformatting needed.
4
+
5
+ ## Installation Methods
6
+
7
+ ### Method 1: Direct install from GitHub (recommended)
8
+
9
+ ```bash
10
+ gemini skills install https://github.com/ckelsoe/prompt-architect.git
11
+ ```
12
+
13
+ Gemini CLI will discover the skill from the `skills/prompt-architect/SKILL.md` file automatically.
14
+
15
+ ### Method 2: Install from npm package
16
+
17
+ ```bash
18
+ npm install -g @ckelsoe/prompt-architect
19
+ # Then copy or link the skill directory:
20
+ gemini skills link "$(npm root -g)/@ckelsoe/prompt-architect/skills/prompt-architect"
21
+ ```
22
+
23
+ ### Method 3: Manual copy
24
+
25
+ Copy the `skills/prompt-architect/` directory to one of Gemini CLI's skill locations:
26
+
27
+ ```bash
28
+ # User-wide (available in all projects)
29
+ cp -r skills/prompt-architect/ ~/.gemini/skills/prompt-architect/
30
+
31
+ # Or use the universal Agent Skills path
32
+ cp -r skills/prompt-architect/ ~/.agents/skills/prompt-architect/
33
+
34
+ # Or workspace-specific
35
+ cp -r skills/prompt-architect/ .gemini/skills/prompt-architect/
36
+ ```
37
+
38
+ ## How It Works
39
+
40
+ 1. **Discovery**: At session start, Gemini CLI loads the skill's `name` and `description` from `SKILL.md` frontmatter
41
+ 2. **Activation**: When you ask about prompt improvement, Gemini identifies the skill match and asks for confirmation
42
+ 3. **Execution**: Upon approval, the full `SKILL.md` instructions load into context along with access to the `references/frameworks/` docs
43
+
44
+ ## Verify Installation
45
+
46
+ ```bash
47
+ # List installed skills
48
+ gemini skills list
49
+
50
+ # Or within a session
51
+ /skills list
52
+ ```
53
+
54
+ Then test with: `"Help me improve this prompt: write a blog post"`
55
+
56
+ You should see intent detection, framework recommendation, and clarifying questions.
57
+
58
+ ## Skill Management
59
+
60
+ ```bash
61
+ gemini skills enable prompt-architect
62
+ gemini skills disable prompt-architect
63
+ gemini skills uninstall prompt-architect
64
+ ```
65
+
66
+ ## Notes
67
+
68
+ - Gemini CLI supports progressive disclosure — only the skill name and description are loaded at startup. The full instructions load on activation.
69
+ - Reference files in `references/frameworks/` are accessible to Gemini CLI once the skill is activated, providing the same deep framework knowledge as the Claude Code version.
70
+ - The `.agents/skills/` path is the universal Agent Skills location recognized by 30+ compatible tools.
@@ -0,0 +1,141 @@
1
+ # Prompt Architect — GitHub Copilot Adapter
2
+
3
+ ## How to install
4
+
5
+ Copy this file's contents into `.github/copilot-instructions.md` in your repository root.
6
+
7
+ ```bash
8
+ mkdir -p .github
9
+ cat node_modules/@ckelsoe/claude-skill-prompt-architect/adapters/for-github-copilot.md >> .github/copilot-instructions.md
10
+ ```
11
+
12
+ **Important**: If you already have a `.github/copilot-instructions.md`, use `>>` to append, not `>` to overwrite.
13
+
14
+ GitHub Copilot reads this file automatically for all Copilot interactions in this workspace (VS Code, Visual Studio, JetBrains, and GitHub.com).
15
+
16
+ ---
17
+
18
+ ## Prompt Engineering Skill
19
+
20
+ When asked to improve, write, fix, or help with a prompt — or when a user's prompt seems vague or incomplete — act as a prompt engineering expert. Use the intent-based framework selection system below to recommend the right approach, ask targeted questions, and deliver a structured result.
21
+
22
+ **Activate when the user says things like:**
23
+ - "Help me improve this prompt"
24
+ - "Write a better prompt for..."
25
+ - "What framework should I use for..."
26
+ - "This isn't working, can you fix my prompt?"
27
+ - "How should I prompt [tool] to..."
28
+
29
+ **Do not apply prompt engineering to normal code requests** — only activate when the user is explicitly asking for help with a prompt.
30
+
31
+ ---
32
+
33
+ ## Intent-Based Framework Selection
34
+
35
+ Identify **primary intent** first, then select within that category.
36
+
37
+ ### A. RECOVER → RPEF
38
+ *"I have an output but need/lost the prompt"*
39
+
40
+ ### B. CLARIFY → Reverse Role Prompting
41
+ *"I know roughly what I want but struggle to specify it"*
42
+
43
+ ### C. CREATE — New content from scratch
44
+
45
+ | Signal | Framework |
46
+ |--------|-----------|
47
+ | Ultra-minimal, one-off | **APE** |
48
+ | Simple, expertise-driven | **RTF** |
49
+ | Simple, context-driven | **CTF** |
50
+ | Role + context + outcome | **RACE** |
51
+ | Multiple variants needed | **CRISPE** |
52
+ | Business deliverable with KPIs | **BROKE** |
53
+ | Explicit rules/constraints | **CARE** or **TIDD-EC** |
54
+ | Audience, tone, style critical | **CO-STAR** |
55
+ | Multi-step procedure | **RISEN** |
56
+ | Data transformation | **RISE-IE** |
57
+ | Content with reference examples | **RISE-IX** |
58
+
59
+ *TIDD-EC: separate Do/Don't lists. CARE: combined rules + examples.*
60
+
61
+ ### D. TRANSFORM — Improving existing content
62
+
63
+ | Signal | Framework |
64
+ |--------|-----------|
65
+ | Rewrite / refactor / convert | **BAB** |
66
+ | Iterative quality improvement | **Self-Refine** |
67
+ | Compress or densify | **Chain of Density** |
68
+ | Outline-first then expand | **Skeleton of Thought** |
69
+
70
+ ### E. REASON — Reasoning or calculation
71
+
72
+ | Signal | Framework |
73
+ |--------|-----------|
74
+ | Numerical / zero-shot | **Plan-and-Solve (PS+)** |
75
+ | Multi-hop with dependencies | **Least-to-Most** |
76
+ | First-principles needed | **Step-Back** |
77
+ | Multiple approaches to compare | **Tree of Thought** |
78
+ | Verify conditions weren't missed | **RCoT** |
79
+ | Linear step-by-step | **Chain of Thought** |
80
+
81
+ ### F. CRITIQUE — Stress-testing or verifying
82
+
83
+ | Signal | Framework |
84
+ |--------|-----------|
85
+ | General quality improvement | **Self-Refine** |
86
+ | Align to principle/standard | **CAI Critique-Revise** |
87
+ | Strongest opposing argument | **Devil's Advocate** |
88
+ | Find failure modes | **Pre-Mortem** |
89
+ | Verify reasoning conditions | **RCoT** |
90
+
91
+ ### G. AGENTIC → ReAct
92
+ *"Task requires tools; each result informs the next step"*
93
+
94
+ ---
95
+
96
+ ## Clarification Questions
97
+
98
+ Ask 3-5 at a time based on identified gaps:
99
+
100
+ **CO-STAR**: Context, audience, tone, style, objective, format?
101
+ **RISEN**: Role, principles, steps, success criteria, constraints?
102
+ **RISE-IE**: Role, input format, processing steps, output expectations?
103
+ **RISE-IX**: Role, instructions, workflow steps, reference examples?
104
+ **TIDD-EC**: Task type, exact steps, dos, don'ts, examples, context?
105
+ **CTF**: Situation/background, exact task, output format?
106
+ **RTF**: Expertise needed, exact task, output format?
107
+ **APE**: Core action, why it's needed, what success looks like?
108
+ **BAB**: Current state, desired state, transformation rules?
109
+ **RACE**: Role/expertise, action, situational context, expectation?
110
+ **CRISPE**: Capacity/role, insight, instructions, personality, how many variants?
111
+ **BROKE**: Background, role, objective, measurable key results, evolve?
112
+ **CARE**: Context, specific ask, rules/constraints, examples of good output?
113
+ **Tree of Thought**: Problem, 2-5 branches, evaluation criteria?
114
+ **ReAct**: Goal, available tools, stop condition?
115
+ **Skeleton of Thought**: Topic, number of points, expansion depth?
116
+ **Step-Back**: Original question, governing principle?
117
+ **Least-to-Most**: Full problem, ordered subproblems?
118
+ **Plan-and-Solve**: Problem with all numbers/variables?
119
+ **Chain of Thought**: Problem, reasoning steps, verification?
120
+ **Chain of Density**: Content, iterations, optimization goal?
121
+ **Self-Refine**: Output to improve, feedback dimensions, stop condition?
122
+ **CAI Critique-Revise**: The principle, output to critique?
123
+ **Devil's Advocate**: Position to attack, dimensions, rank severity?
124
+ **Pre-Mortem**: Project/decision, time horizon, domains?
125
+ **RCoT**: Question with all conditions, initial answer to verify?
126
+ **RPEF**: Output to reverse-engineer, input data if available?
127
+ **Reverse Role**: Intent, domain of expertise, batch or conversational?
128
+
129
+ ---
130
+
131
+ ## Process
132
+
133
+ 1. Detect intent (A–G above)
134
+ 2. Ask 3-5 clarifying questions
135
+ 3. Apply the selected framework
136
+ 4. Show before/after comparison with explanation
137
+ 5. Iterate based on feedback
138
+
139
+ ## When NOT to Use Frameworks
140
+
141
+ Skip when: prompt is already complete, factual lookup, casual conversation, or the user says "just do it."