@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.
- package/.claude-plugin/marketplace.json +20 -0
- package/.claude-plugin/plugin.json +18 -0
- package/CHANGELOG.md +264 -0
- package/LICENSE +21 -0
- package/MIGRATION.md +66 -0
- package/README.md +1184 -0
- package/adapters/README.md +267 -0
- package/adapters/for-cursor.mdc +138 -0
- package/adapters/for-gemini-cli.md +70 -0
- package/adapters/for-github-copilot.md +141 -0
- package/adapters/for-openai-codex-cli.md +158 -0
- package/adapters/for-windsurf.md +136 -0
- package/adapters/system-prompt.md +243 -0
- package/package.json +135 -0
- package/scripts/install.js +490 -0
- package/scripts/test.js +213 -0
- package/scripts/validate-skill.js +350 -0
- package/skills/prompt-architect/SKILL.md +331 -0
- package/skills/prompt-architect/assets/templates/ape_template.txt +5 -0
- package/skills/prompt-architect/assets/templates/bab_template.txt +15 -0
- package/skills/prompt-architect/assets/templates/broke_template.txt +15 -0
- package/skills/prompt-architect/assets/templates/cai-critique-revise_template.txt +18 -0
- package/skills/prompt-architect/assets/templates/care_template.txt +16 -0
- package/skills/prompt-architect/assets/templates/chain-of-density_template.txt +46 -0
- package/skills/prompt-architect/assets/templates/chain-of-thought_template.txt +49 -0
- package/skills/prompt-architect/assets/templates/co-star_template.txt +17 -0
- package/skills/prompt-architect/assets/templates/crispe_template.txt +14 -0
- package/skills/prompt-architect/assets/templates/ctf_template.txt +15 -0
- package/skills/prompt-architect/assets/templates/devils-advocate_template.txt +25 -0
- package/skills/prompt-architect/assets/templates/hybrid_template.txt +101 -0
- package/skills/prompt-architect/assets/templates/least-to-most_template.txt +16 -0
- package/skills/prompt-architect/assets/templates/plan-and-solve_template.txt +7 -0
- package/skills/prompt-architect/assets/templates/pre-mortem_template.txt +27 -0
- package/skills/prompt-architect/assets/templates/race_template.txt +19 -0
- package/skills/prompt-architect/assets/templates/rcot_template.txt +31 -0
- package/skills/prompt-architect/assets/templates/react_template.txt +27 -0
- package/skills/prompt-architect/assets/templates/reverse-role_template.txt +11 -0
- package/skills/prompt-architect/assets/templates/rise-ie_template.txt +23 -0
- package/skills/prompt-architect/assets/templates/rise-ix_template.txt +28 -0
- package/skills/prompt-architect/assets/templates/risen_template.txt +21 -0
- package/skills/prompt-architect/assets/templates/rpef_template.txt +26 -0
- package/skills/prompt-architect/assets/templates/rtf_template.txt +13 -0
- package/skills/prompt-architect/assets/templates/self-refine_template.txt +16 -0
- package/skills/prompt-architect/assets/templates/skeleton-of-thought_template.txt +15 -0
- package/skills/prompt-architect/assets/templates/step-back_template.txt +10 -0
- package/skills/prompt-architect/assets/templates/tidd-ec_template.txt +45 -0
- package/skills/prompt-architect/assets/templates/tree-of-thought_template.txt +30 -0
- package/skills/prompt-architect/references/frameworks/ape.md +200 -0
- package/skills/prompt-architect/references/frameworks/bab.md +242 -0
- package/skills/prompt-architect/references/frameworks/broke.md +242 -0
- package/skills/prompt-architect/references/frameworks/cai-critique-revise.md +230 -0
- package/skills/prompt-architect/references/frameworks/care.md +235 -0
- package/skills/prompt-architect/references/frameworks/chain-of-density.md +479 -0
- package/skills/prompt-architect/references/frameworks/chain-of-thought.md +424 -0
- package/skills/prompt-architect/references/frameworks/co-star.md +256 -0
- package/skills/prompt-architect/references/frameworks/crispe.md +253 -0
- package/skills/prompt-architect/references/frameworks/ctf.md +207 -0
- package/skills/prompt-architect/references/frameworks/devils-advocate.md +206 -0
- package/skills/prompt-architect/references/frameworks/least-to-most.md +226 -0
- package/skills/prompt-architect/references/frameworks/plan-and-solve.md +210 -0
- package/skills/prompt-architect/references/frameworks/pre-mortem.md +197 -0
- package/skills/prompt-architect/references/frameworks/race.md +243 -0
- package/skills/prompt-architect/references/frameworks/rcot.md +203 -0
- package/skills/prompt-architect/references/frameworks/react.md +304 -0
- package/skills/prompt-architect/references/frameworks/reverse-role.md +189 -0
- package/skills/prompt-architect/references/frameworks/rise.md +555 -0
- package/skills/prompt-architect/references/frameworks/risen.md +297 -0
- package/skills/prompt-architect/references/frameworks/rpef.md +195 -0
- package/skills/prompt-architect/references/frameworks/rtf.md +358 -0
- package/skills/prompt-architect/references/frameworks/self-refine.md +205 -0
- package/skills/prompt-architect/references/frameworks/skeleton-of-thought.md +186 -0
- package/skills/prompt-architect/references/frameworks/step-back.md +206 -0
- package/skills/prompt-architect/references/frameworks/tidd-ec.md +470 -0
- package/skills/prompt-architect/references/frameworks/tree-of-thought.md +260 -0
- package/skills/prompt-architect/scripts/framework_analyzer.py +807 -0
- 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."
|