@ckelsoe/prompt-architect 3.0.2 → 3.2.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 +1 -1
- package/.claude-plugin/plugin.json +1 -1
- package/CHANGELOG.md +264 -264
- package/LICENSE +21 -21
- package/README.md +1064 -1184
- package/adapters/README.md +75 -267
- package/adapters/for-windsurf.md +136 -136
- package/adapters/system-prompt.md +243 -243
- package/package.json +139 -138
- package/scripts/build-skill.js +64 -0
- package/scripts/install.js +4 -54
- package/scripts/test.js +205 -213
- package/scripts/validate-skill.js +350 -350
- package/skills/prompt-architect/SKILL.md +343 -331
- package/skills/prompt-architect/assets/templates/ape_template.txt +5 -5
- package/skills/prompt-architect/assets/templates/bab_template.txt +15 -15
- package/skills/prompt-architect/assets/templates/broke_template.txt +15 -15
- package/skills/prompt-architect/assets/templates/cai-critique-revise_template.txt +18 -18
- package/skills/prompt-architect/assets/templates/care_template.txt +16 -16
- package/skills/prompt-architect/assets/templates/chain-of-density_template.txt +46 -46
- package/skills/prompt-architect/assets/templates/chain-of-thought_template.txt +49 -49
- package/skills/prompt-architect/assets/templates/co-star_template.txt +17 -17
- package/skills/prompt-architect/assets/templates/crispe_template.txt +14 -14
- package/skills/prompt-architect/assets/templates/ctf_template.txt +15 -15
- package/skills/prompt-architect/assets/templates/devils-advocate_template.txt +25 -25
- package/skills/prompt-architect/assets/templates/hybrid_template.txt +101 -101
- package/skills/prompt-architect/assets/templates/least-to-most_template.txt +16 -16
- package/skills/prompt-architect/assets/templates/plan-and-solve_template.txt +7 -7
- package/skills/prompt-architect/assets/templates/pre-mortem_template.txt +27 -27
- package/skills/prompt-architect/assets/templates/race_template.txt +19 -19
- package/skills/prompt-architect/assets/templates/rcot_template.txt +31 -31
- package/skills/prompt-architect/assets/templates/react_template.txt +27 -27
- package/skills/prompt-architect/assets/templates/reverse-role_template.txt +11 -11
- package/skills/prompt-architect/assets/templates/rise-ie_template.txt +23 -23
- package/skills/prompt-architect/assets/templates/rise-ix_template.txt +28 -28
- package/skills/prompt-architect/assets/templates/risen_template.txt +21 -21
- package/skills/prompt-architect/assets/templates/rpef_template.txt +26 -26
- package/skills/prompt-architect/assets/templates/rtf_template.txt +13 -13
- package/skills/prompt-architect/assets/templates/self-refine_template.txt +16 -16
- package/skills/prompt-architect/assets/templates/skeleton-of-thought_template.txt +15 -15
- package/skills/prompt-architect/assets/templates/step-back_template.txt +10 -10
- package/skills/prompt-architect/assets/templates/tidd-ec_template.txt +45 -45
- package/skills/prompt-architect/assets/templates/tree-of-thought_template.txt +30 -30
- package/skills/prompt-architect/references/frameworks/ape.md +200 -200
- package/skills/prompt-architect/references/frameworks/bab.md +242 -242
- package/skills/prompt-architect/references/frameworks/broke.md +242 -242
- package/skills/prompt-architect/references/frameworks/cai-critique-revise.md +230 -230
- package/skills/prompt-architect/references/frameworks/care.md +235 -235
- package/skills/prompt-architect/references/frameworks/chain-of-density.md +479 -479
- package/skills/prompt-architect/references/frameworks/chain-of-thought.md +424 -424
- package/skills/prompt-architect/references/frameworks/co-star.md +256 -256
- package/skills/prompt-architect/references/frameworks/crispe.md +253 -253
- package/skills/prompt-architect/references/frameworks/ctf.md +207 -207
- package/skills/prompt-architect/references/frameworks/devils-advocate.md +206 -206
- package/skills/prompt-architect/references/frameworks/least-to-most.md +226 -226
- package/skills/prompt-architect/references/frameworks/plan-and-solve.md +210 -210
- package/skills/prompt-architect/references/frameworks/pre-mortem.md +197 -197
- package/skills/prompt-architect/references/frameworks/race.md +243 -243
- package/skills/prompt-architect/references/frameworks/rcot.md +203 -203
- package/skills/prompt-architect/references/frameworks/react.md +304 -304
- package/skills/prompt-architect/references/frameworks/reverse-role.md +189 -189
- package/skills/prompt-architect/references/frameworks/rise.md +555 -555
- package/skills/prompt-architect/references/frameworks/risen.md +297 -297
- package/skills/prompt-architect/references/frameworks/rpef.md +195 -195
- package/skills/prompt-architect/references/frameworks/rtf.md +358 -358
- package/skills/prompt-architect/references/frameworks/self-refine.md +205 -205
- package/skills/prompt-architect/references/frameworks/skeleton-of-thought.md +186 -186
- package/skills/prompt-architect/references/frameworks/step-back.md +206 -206
- package/skills/prompt-architect/references/frameworks/tidd-ec.md +470 -470
- package/skills/prompt-architect/references/frameworks/tree-of-thought.md +260 -260
- package/skills/prompt-architect/scripts/framework_analyzer.py +807 -807
- package/skills/prompt-architect/scripts/prompt_evaluator.py +336 -336
- package/adapters/for-cursor.mdc +0 -138
- package/adapters/for-gemini-cli.md +0 -70
- package/adapters/for-github-copilot.md +0 -141
- package/adapters/for-openai-codex-cli.md +0 -158
package/adapters/README.md
CHANGED
|
@@ -1,267 +1,75 @@
|
|
|
1
|
-
# Prompt Architect —
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
**
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
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."`
|
|
1
|
+
# Prompt Architect — Adapters
|
|
2
|
+
|
|
3
|
+
Most AI tools now support the [Agent Skills standard](https://agentskills.io) natively and can use `skills/prompt-architect/SKILL.md` directly. The adapters in this folder are for the remaining tools that need a reformatted version.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Installation by tool
|
|
8
|
+
|
|
9
|
+
### Agent Skills compatible tools (recommended)
|
|
10
|
+
|
|
11
|
+
These tools read `SKILL.md` natively. No adapter needed — just install to their skills directory:
|
|
12
|
+
|
|
13
|
+
| Tool | Install method |
|
|
14
|
+
|------|---------------|
|
|
15
|
+
| **Claude Code** | `npm install -g @ckelsoe/prompt-architect` or `/plugin marketplace add ckelsoe/prompt-architect` |
|
|
16
|
+
| **ChatGPT** | Download [`prompt-architect.skill`](https://github.com/ckelsoe/prompt-architect/releases/latest) → Profile → Skills → Upload |
|
|
17
|
+
| **Gemini CLI** | `gemini skills install https://github.com/ckelsoe/prompt-architect.git` |
|
|
18
|
+
| **Cursor** | Copy `skills/prompt-architect/` to `.agents/skills/` or `.cursor/skills/` in your project |
|
|
19
|
+
| **GitHub Copilot** | Copy `skills/prompt-architect/` to `.github/skills/` or `~/.copilot/skills/` |
|
|
20
|
+
| **OpenAI Codex** | Copy `skills/prompt-architect/` to `.agents/skills/` in your project |
|
|
21
|
+
| **VS Code** | Copy `skills/prompt-architect/` to `.agents/skills/` in your project |
|
|
22
|
+
| **Roo Code** | Copy `skills/prompt-architect/` to `.agents/skills/` or `~/.agents/skills/` |
|
|
23
|
+
| **Kiro, Amp, Junie, Goose, OpenHands, etc.** | Copy to `~/.agents/skills/` (universal path) |
|
|
24
|
+
|
|
25
|
+
Or use the interactive installer to auto-detect and install:
|
|
26
|
+
```bash
|
|
27
|
+
npx @ckelsoe/prompt-architect
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
### Windsurf
|
|
31
|
+
|
|
32
|
+
Windsurf does not yet support Agent Skills natively. Use the adapter file:
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
# New file
|
|
36
|
+
cp adapters/for-windsurf.md ./.windsurfrules
|
|
37
|
+
|
|
38
|
+
# Or append to existing
|
|
39
|
+
cat adapters/for-windsurf.md >> ./.windsurfrules
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
### Any LLM API or Chat Interface
|
|
43
|
+
|
|
44
|
+
Use `system-prompt.md` as your system prompt. Works with OpenAI API, Anthropic API, Google Gemini API, or any tool with a system prompt / custom instructions field.
|
|
45
|
+
|
|
46
|
+
**Direct link:** [system-prompt.md on GitHub](https://raw.githubusercontent.com/ckelsoe/prompt-architect/main/adapters/system-prompt.md)
|
|
47
|
+
|
|
48
|
+
**For ChatGPT Custom GPTs** (free/personal plans without Skills support):
|
|
49
|
+
1. Open the [system-prompt.md](https://raw.githubusercontent.com/ckelsoe/prompt-architect/main/adapters/system-prompt.md) link
|
|
50
|
+
2. Copy the entire contents
|
|
51
|
+
3. Go to [chat.openai.com](https://chat.openai.com) → Explore GPTs → Create a GPT → Configure
|
|
52
|
+
4. Paste into the "Instructions" field
|
|
53
|
+
5. Name it "Prompt Architect" and save
|
|
54
|
+
|
|
55
|
+
---
|
|
56
|
+
|
|
57
|
+
## Adapter files in this folder
|
|
58
|
+
|
|
59
|
+
| File | Use with |
|
|
60
|
+
|------|----------|
|
|
61
|
+
| `system-prompt.md` | Any LLM API, Custom GPTs, or tool without Agent Skills support |
|
|
62
|
+
| `for-windsurf.md` | Windsurf editor (`.windsurfrules` format) |
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
## Why most adapters were removed (v3.0)
|
|
67
|
+
|
|
68
|
+
In v2.x, this folder contained adapters for Cursor, GitHub Copilot, OpenAI Codex, and Gemini CLI. All of these tools have since adopted the [Agent Skills standard](https://agentskills.io) and now read `SKILL.md` natively. The old adapter files were:
|
|
69
|
+
|
|
70
|
+
- `for-cursor.mdc` → Cursor now scans `.cursor/skills/` and `.agents/skills/`
|
|
71
|
+
- `for-github-copilot.md` → Copilot now scans `.github/skills/` and `~/.copilot/skills/`
|
|
72
|
+
- `for-openai-codex-cli.md` → Codex now scans `.agents/skills/`
|
|
73
|
+
- `for-gemini-cli.md` → Gemini CLI scans `~/.gemini/skills/` and `~/.agents/skills/`
|
|
74
|
+
|
|
75
|
+
If you need these for legacy setups, check the [v2.1.4 release](https://github.com/ckelsoe/prompt-architect/tree/v2.1.4/adapters).
|
package/adapters/for-windsurf.md
CHANGED
|
@@ -1,136 +1,136 @@
|
|
|
1
|
-
# Prompt Architect — Windsurf Adapter
|
|
2
|
-
|
|
3
|
-
## How to install
|
|
4
|
-
|
|
5
|
-
Copy this file's contents into `.windsurfrules` in your project root.
|
|
6
|
-
|
|
7
|
-
```bash
|
|
8
|
-
cat node_modules/@ckelsoe/claude-skill-prompt-architect/adapters/for-windsurf.md >> .windsurfrules
|
|
9
|
-
```
|
|
10
|
-
|
|
11
|
-
**Important**: If you already have a `.windsurfrules` file, use `>>` to append, not `>` to overwrite.
|
|
12
|
-
|
|
13
|
-
Windsurf reads `.windsurfrules` automatically at the start of each session.
|
|
14
|
-
|
|
15
|
-
---
|
|
16
|
-
|
|
17
|
-
## Prompt Engineering Skill
|
|
18
|
-
|
|
19
|
-
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.
|
|
20
|
-
|
|
21
|
-
**Activate for requests like:**
|
|
22
|
-
- "Help me improve this prompt"
|
|
23
|
-
- "Write a better prompt for..."
|
|
24
|
-
- "What framework should I use?"
|
|
25
|
-
- "This prompt isn't working, fix it"
|
|
26
|
-
|
|
27
|
-
**Do not apply prompt engineering to normal code or task requests** — only activate when the user is explicitly asking for help with a prompt.
|
|
28
|
-
|
|
29
|
-
---
|
|
30
|
-
|
|
31
|
-
## Intent-Based Framework Selection
|
|
32
|
-
|
|
33
|
-
Identify **primary intent** first, then select within that category.
|
|
34
|
-
|
|
35
|
-
**A. RECOVER** → **RPEF**
|
|
36
|
-
*"I have an output but need/lost the prompt"*
|
|
37
|
-
|
|
38
|
-
**B. CLARIFY** → **Reverse Role Prompting**
|
|
39
|
-
*"I know roughly what I want but struggle to specify it"*
|
|
40
|
-
|
|
41
|
-
**C. CREATE** — New content from scratch
|
|
42
|
-
|
|
43
|
-
Signal → Framework:
|
|
44
|
-
- Ultra-minimal, one-off → APE
|
|
45
|
-
- Simple, expertise-driven → RTF
|
|
46
|
-
- Simple, context-driven → CTF
|
|
47
|
-
- Role + context + outcome → RACE
|
|
48
|
-
- Multiple variants needed → CRISPE
|
|
49
|
-
- Business deliverable with KPIs → BROKE
|
|
50
|
-
- Explicit rules/constraints → CARE or TIDD-EC
|
|
51
|
-
- Audience, tone, style critical → CO-STAR
|
|
52
|
-
- Multi-step procedure → RISEN
|
|
53
|
-
- Data transformation → RISE-IE
|
|
54
|
-
- Content with reference examples → RISE-IX
|
|
55
|
-
|
|
56
|
-
TIDD-EC: use when you need separate Do/Don't lists.
|
|
57
|
-
CARE: use when rules and examples are combined.
|
|
58
|
-
|
|
59
|
-
**D. TRANSFORM** — Improving existing content
|
|
60
|
-
|
|
61
|
-
Signal → Framework:
|
|
62
|
-
- Rewrite / refactor / convert → BAB
|
|
63
|
-
- Iterative quality improvement → Self-Refine
|
|
64
|
-
- Compress or densify → Chain of Density
|
|
65
|
-
- Outline-first then expand → Skeleton of Thought
|
|
66
|
-
|
|
67
|
-
**E. REASON** — Reasoning or calculation
|
|
68
|
-
|
|
69
|
-
Signal → Framework:
|
|
70
|
-
- Numerical / zero-shot calculation → Plan-and-Solve (PS+)
|
|
71
|
-
- Multi-hop with dependencies → Least-to-Most
|
|
72
|
-
- First-principles needed first → Step-Back
|
|
73
|
-
- Multiple approaches to compare → Tree of Thought
|
|
74
|
-
- Verify conditions weren't missed → RCoT
|
|
75
|
-
- Linear step-by-step → Chain of Thought
|
|
76
|
-
|
|
77
|
-
**F. CRITIQUE** — Stress-testing or verifying
|
|
78
|
-
|
|
79
|
-
Signal → Framework:
|
|
80
|
-
- General quality improvement → Self-Refine
|
|
81
|
-
- Align to principle/standard → CAI Critique-Revise
|
|
82
|
-
- Strongest opposing argument → Devil's Advocate
|
|
83
|
-
- Find failure modes before launch → Pre-Mortem
|
|
84
|
-
- Verify reasoning conditions → RCoT
|
|
85
|
-
|
|
86
|
-
**G. AGENTIC** → **ReAct**
|
|
87
|
-
*"Task requires tools; each result informs the next step"*
|
|
88
|
-
|
|
89
|
-
---
|
|
90
|
-
|
|
91
|
-
## Clarification Questions (3-5 at a time)
|
|
92
|
-
|
|
93
|
-
CO-STAR: Context, audience, tone, style, objective, format?
|
|
94
|
-
RISEN: Role, principles, steps, success criteria, constraints?
|
|
95
|
-
RISE-IE: Role, input format, processing steps, output expectations?
|
|
96
|
-
RISE-IX: Role, instructions, workflow steps, reference examples?
|
|
97
|
-
TIDD-EC: Task type, exact steps, dos, don'ts, examples, context?
|
|
98
|
-
CTF: Situation/background, exact task, output format?
|
|
99
|
-
RTF: Expertise needed, exact task, output format?
|
|
100
|
-
APE: Core action, why it's needed, what success looks like?
|
|
101
|
-
BAB: Current state, desired state, transformation rules?
|
|
102
|
-
RACE: Role/expertise, action, situational context, expectation?
|
|
103
|
-
CRISPE: Capacity/role, insight, instructions, personality, how many variants?
|
|
104
|
-
BROKE: Background, role, objective, measurable key results, evolve?
|
|
105
|
-
CARE: Context, specific ask, rules/constraints, examples of good output?
|
|
106
|
-
Tree of Thought: Problem, 2-5 branches, evaluation criteria?
|
|
107
|
-
ReAct: Goal, available tools, stop condition?
|
|
108
|
-
Skeleton of Thought: Topic, number of points, expansion depth?
|
|
109
|
-
Step-Back: Original question, governing principle?
|
|
110
|
-
Least-to-Most: Full problem, ordered subproblems?
|
|
111
|
-
Plan-and-Solve: Problem with all numbers/variables?
|
|
112
|
-
Chain of Thought: Problem, reasoning steps, verification?
|
|
113
|
-
Chain of Density: Content, iterations, optimization goal?
|
|
114
|
-
Self-Refine: Output to improve, feedback dimensions, stop condition?
|
|
115
|
-
CAI Critique-Revise: The principle, output to critique?
|
|
116
|
-
Devil's Advocate: Position to attack, dimensions, rank severity?
|
|
117
|
-
Pre-Mortem: Project/decision, time horizon, domains?
|
|
118
|
-
RCoT: Question with all conditions, initial answer to verify?
|
|
119
|
-
RPEF: Output to reverse-engineer, input data if available?
|
|
120
|
-
Reverse Role: Intent, domain of expertise, batch or conversational?
|
|
121
|
-
|
|
122
|
-
---
|
|
123
|
-
|
|
124
|
-
## Process
|
|
125
|
-
|
|
126
|
-
1. Detect intent (A-G above)
|
|
127
|
-
2. Ask 3-5 clarifying questions
|
|
128
|
-
3. Apply the selected framework
|
|
129
|
-
4. Show before/after comparison with explanation
|
|
130
|
-
5. Iterate based on feedback
|
|
131
|
-
|
|
132
|
-
## When NOT to Use Frameworks
|
|
133
|
-
|
|
134
|
-
Skip when: prompt is already complete, factual lookup, casual conversation, or user says "just do it."
|
|
135
|
-
|
|
136
|
-
Rule of thumb: Use a framework when there's a gap between what was asked and what's needed.
|
|
1
|
+
# Prompt Architect — Windsurf Adapter
|
|
2
|
+
|
|
3
|
+
## How to install
|
|
4
|
+
|
|
5
|
+
Copy this file's contents into `.windsurfrules` in your project root.
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
cat node_modules/@ckelsoe/claude-skill-prompt-architect/adapters/for-windsurf.md >> .windsurfrules
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
**Important**: If you already have a `.windsurfrules` file, use `>>` to append, not `>` to overwrite.
|
|
12
|
+
|
|
13
|
+
Windsurf reads `.windsurfrules` automatically at the start of each session.
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## Prompt Engineering Skill
|
|
18
|
+
|
|
19
|
+
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.
|
|
20
|
+
|
|
21
|
+
**Activate for requests like:**
|
|
22
|
+
- "Help me improve this prompt"
|
|
23
|
+
- "Write a better prompt for..."
|
|
24
|
+
- "What framework should I use?"
|
|
25
|
+
- "This prompt isn't working, fix it"
|
|
26
|
+
|
|
27
|
+
**Do not apply prompt engineering to normal code or task requests** — only activate when the user is explicitly asking for help with a prompt.
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
## Intent-Based Framework Selection
|
|
32
|
+
|
|
33
|
+
Identify **primary intent** first, then select within that category.
|
|
34
|
+
|
|
35
|
+
**A. RECOVER** → **RPEF**
|
|
36
|
+
*"I have an output but need/lost the prompt"*
|
|
37
|
+
|
|
38
|
+
**B. CLARIFY** → **Reverse Role Prompting**
|
|
39
|
+
*"I know roughly what I want but struggle to specify it"*
|
|
40
|
+
|
|
41
|
+
**C. CREATE** — New content from scratch
|
|
42
|
+
|
|
43
|
+
Signal → Framework:
|
|
44
|
+
- Ultra-minimal, one-off → APE
|
|
45
|
+
- Simple, expertise-driven → RTF
|
|
46
|
+
- Simple, context-driven → CTF
|
|
47
|
+
- Role + context + outcome → RACE
|
|
48
|
+
- Multiple variants needed → CRISPE
|
|
49
|
+
- Business deliverable with KPIs → BROKE
|
|
50
|
+
- Explicit rules/constraints → CARE or TIDD-EC
|
|
51
|
+
- Audience, tone, style critical → CO-STAR
|
|
52
|
+
- Multi-step procedure → RISEN
|
|
53
|
+
- Data transformation → RISE-IE
|
|
54
|
+
- Content with reference examples → RISE-IX
|
|
55
|
+
|
|
56
|
+
TIDD-EC: use when you need separate Do/Don't lists.
|
|
57
|
+
CARE: use when rules and examples are combined.
|
|
58
|
+
|
|
59
|
+
**D. TRANSFORM** — Improving existing content
|
|
60
|
+
|
|
61
|
+
Signal → Framework:
|
|
62
|
+
- Rewrite / refactor / convert → BAB
|
|
63
|
+
- Iterative quality improvement → Self-Refine
|
|
64
|
+
- Compress or densify → Chain of Density
|
|
65
|
+
- Outline-first then expand → Skeleton of Thought
|
|
66
|
+
|
|
67
|
+
**E. REASON** — Reasoning or calculation
|
|
68
|
+
|
|
69
|
+
Signal → Framework:
|
|
70
|
+
- Numerical / zero-shot calculation → Plan-and-Solve (PS+)
|
|
71
|
+
- Multi-hop with dependencies → Least-to-Most
|
|
72
|
+
- First-principles needed first → Step-Back
|
|
73
|
+
- Multiple approaches to compare → Tree of Thought
|
|
74
|
+
- Verify conditions weren't missed → RCoT
|
|
75
|
+
- Linear step-by-step → Chain of Thought
|
|
76
|
+
|
|
77
|
+
**F. CRITIQUE** — Stress-testing or verifying
|
|
78
|
+
|
|
79
|
+
Signal → Framework:
|
|
80
|
+
- General quality improvement → Self-Refine
|
|
81
|
+
- Align to principle/standard → CAI Critique-Revise
|
|
82
|
+
- Strongest opposing argument → Devil's Advocate
|
|
83
|
+
- Find failure modes before launch → Pre-Mortem
|
|
84
|
+
- Verify reasoning conditions → RCoT
|
|
85
|
+
|
|
86
|
+
**G. AGENTIC** → **ReAct**
|
|
87
|
+
*"Task requires tools; each result informs the next step"*
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
|
|
91
|
+
## Clarification Questions (3-5 at a time)
|
|
92
|
+
|
|
93
|
+
CO-STAR: Context, audience, tone, style, objective, format?
|
|
94
|
+
RISEN: Role, principles, steps, success criteria, constraints?
|
|
95
|
+
RISE-IE: Role, input format, processing steps, output expectations?
|
|
96
|
+
RISE-IX: Role, instructions, workflow steps, reference examples?
|
|
97
|
+
TIDD-EC: Task type, exact steps, dos, don'ts, examples, context?
|
|
98
|
+
CTF: Situation/background, exact task, output format?
|
|
99
|
+
RTF: Expertise needed, exact task, output format?
|
|
100
|
+
APE: Core action, why it's needed, what success looks like?
|
|
101
|
+
BAB: Current state, desired state, transformation rules?
|
|
102
|
+
RACE: Role/expertise, action, situational context, expectation?
|
|
103
|
+
CRISPE: Capacity/role, insight, instructions, personality, how many variants?
|
|
104
|
+
BROKE: Background, role, objective, measurable key results, evolve?
|
|
105
|
+
CARE: Context, specific ask, rules/constraints, examples of good output?
|
|
106
|
+
Tree of Thought: Problem, 2-5 branches, evaluation criteria?
|
|
107
|
+
ReAct: Goal, available tools, stop condition?
|
|
108
|
+
Skeleton of Thought: Topic, number of points, expansion depth?
|
|
109
|
+
Step-Back: Original question, governing principle?
|
|
110
|
+
Least-to-Most: Full problem, ordered subproblems?
|
|
111
|
+
Plan-and-Solve: Problem with all numbers/variables?
|
|
112
|
+
Chain of Thought: Problem, reasoning steps, verification?
|
|
113
|
+
Chain of Density: Content, iterations, optimization goal?
|
|
114
|
+
Self-Refine: Output to improve, feedback dimensions, stop condition?
|
|
115
|
+
CAI Critique-Revise: The principle, output to critique?
|
|
116
|
+
Devil's Advocate: Position to attack, dimensions, rank severity?
|
|
117
|
+
Pre-Mortem: Project/decision, time horizon, domains?
|
|
118
|
+
RCoT: Question with all conditions, initial answer to verify?
|
|
119
|
+
RPEF: Output to reverse-engineer, input data if available?
|
|
120
|
+
Reverse Role: Intent, domain of expertise, batch or conversational?
|
|
121
|
+
|
|
122
|
+
---
|
|
123
|
+
|
|
124
|
+
## Process
|
|
125
|
+
|
|
126
|
+
1. Detect intent (A-G above)
|
|
127
|
+
2. Ask 3-5 clarifying questions
|
|
128
|
+
3. Apply the selected framework
|
|
129
|
+
4. Show before/after comparison with explanation
|
|
130
|
+
5. Iterate based on feedback
|
|
131
|
+
|
|
132
|
+
## When NOT to Use Frameworks
|
|
133
|
+
|
|
134
|
+
Skip when: prompt is already complete, factual lookup, casual conversation, or user says "just do it."
|
|
135
|
+
|
|
136
|
+
Rule of thumb: Use a framework when there's a gap between what was asked and what's needed.
|