You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: .claude/skills/doc-coauthoring/SKILL.md
+19Lines changed: 19 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,6 +10,7 @@ This skill provides a structured workflow for guiding users through collaborativ
10
10
## When to Offer This Workflow
11
11
12
12
**Trigger conditions:**
13
+
13
14
- User mentions writing documentation: "write a doc", "draft a proposal", "create a spec", "write up"
14
15
- User mentions specific doc types: "PRD", "design doc", "decision doc", "RFC"
15
16
- User seems to be starting a substantial writing task
@@ -42,18 +43,21 @@ Start by asking the user for meta-context about the document:
42
43
Inform them they can answer in shorthand or dump information however works best for them.
43
44
44
45
**If user provides a template or mentions a doc type:**
46
+
45
47
- Ask if they have a template document to share
46
48
- If they provide a link to a shared document, use the appropriate integration to fetch it
47
49
- If they provide a file, read it
48
50
49
51
**If user mentions editing an existing shared document:**
52
+
50
53
- Use the appropriate integration to read the current state
51
54
- Check for images without alt-text
52
55
- If images exist without alt-text, explain that when others use Claude to understand the doc, Claude won't be able to see them. Ask if they want alt-text generated. If so, request they paste each image into chat for descriptive alt-text generation.
53
56
54
57
### Info Dumping
55
58
56
59
Once initial questions are answered, encourage the user to dump all the context they have. Request information such as:
60
+
57
61
- Background on the project/problem
58
62
- Related team discussions or shared documents
59
63
- Why alternative solutions aren't being used
@@ -63,6 +67,7 @@ Once initial questions are answered, encourage the user to dump all the context
63
67
- Stakeholder concerns
64
68
65
69
Advise them not to worry about organizing it - just get it all out. Offer multiple ways to provide context:
70
+
66
71
- Info dump stream-of-consciousness
67
72
- Point to team channels or threads to read
68
73
- Link to shared documents
@@ -107,6 +112,7 @@ If user wants to add more, let them. When ready, proceed to Stage 2.
107
112
108
113
**Instructions to user:**
109
114
Explain that the document will be built section by section. For each section:
115
+
110
116
1. Clarifying questions will be asked about what to include
111
117
2. 5-20 options will be brainstormed
112
118
3. User will indicate what to keep/remove/combine
@@ -162,6 +168,7 @@ Inform them they can answer in shorthand or just indicate what's important to co
162
168
### Step 2: Brainstorming
163
169
164
170
For the [SECTION NAME] section, brainstorm [5-20] things that might be included, depending on the section's complexity. Look for:
171
+
165
172
- Context shared that might have been forgotten
166
173
- Angles or considerations not yet mentioned
167
174
@@ -172,6 +179,7 @@ Generate 5-20 numbered options based on section complexity. At the end, offer to
172
179
Ask which points should be kept, removed, or combined. Request brief justifications to help learn priorities for the next sections.
173
180
174
181
Provide examples:
182
+
175
183
- "Keep 1,4,7,9"
176
184
- "Remove 3 (duplicates 1)"
177
185
- "Remove 6 (audience already knows this)"
@@ -205,6 +213,7 @@ Provide a note: Instead of editing the doc directly, ask them to indicate what t
205
213
### Step 6: Iterative Refinement
206
214
207
215
As user provides feedback:
216
+
208
217
- Use `str_replace` to make edits (never reprint the whole doc)
209
218
-**If using artifacts:** Provide link to artifact after each edit
210
219
-**If using files:** Just confirm edits are complete
@@ -223,6 +232,7 @@ When section is done, confirm [SECTION NAME] is complete. Ask if ready to move t
223
232
### Near Completion
224
233
225
234
As approaching completion (80%+ of sections done), announce intention to re-read the entire document and check for:
235
+
226
236
- Flow and consistency across sections
227
237
- Redundancy or contradictions
228
238
- Anything that feels like "slop" or generic filler
@@ -300,11 +310,13 @@ Generate 5-10 questions that readers would realistically ask.
300
310
### Step 2: Setup Testing
301
311
302
312
Provide testing instructions:
313
+
303
314
1. Open a fresh Claude conversation: https://claude.ai
304
315
2. Paste or share the document content (if using a shared doc platform with connectors enabled, provide the link)
305
316
3. Ask Reader Claude the generated questions
306
317
307
318
For each question, instruct Reader Claude to provide:
319
+
308
320
- The answer
309
321
- Whether anything was ambiguous or unclear
310
322
- What knowledge/context the doc assumes is already known
@@ -314,6 +326,7 @@ Check if Reader Claude gives correct answers or misinterprets anything.
314
326
### Step 3: Additional Checks
315
327
316
328
Also ask Reader Claude:
329
+
317
330
- "What in this doc might be ambiguous or unclear to readers?"
318
331
- "What knowledge or context does this doc assume readers already have?"
319
332
- "Are there any internal contradictions or inconsistencies?"
@@ -343,33 +356,39 @@ Ask if they want one more review, or if the work is done.
343
356
344
357
**If user wants final review, provide it. Otherwise:**
345
358
Announce document completion. Provide a few final tips:
359
+
346
360
- Consider linking this conversation in an appendix so readers can see how the doc was developed
347
361
- Use appendices to provide depth without bloating the main doc
348
362
- Update the doc as feedback is received from real readers
349
363
350
364
## Tips for Effective Guidance
351
365
352
366
**Tone:**
367
+
353
368
- Be direct and procedural
354
369
- Explain rationale briefly when it affects user behavior
355
370
- Don't try to "sell" the approach - just execute it
356
371
357
372
**Handling Deviations:**
373
+
358
374
- If user wants to skip a stage: Ask if they want to skip this and write freeform
359
375
- If user seems frustrated: Acknowledge this is taking longer than expected. Suggest ways to move faster
360
376
- Always give user agency to adjust the process
361
377
362
378
**Context Management:**
379
+
363
380
- Throughout, if context is missing on something mentioned, proactively ask
364
381
- Don't let gaps accumulate - address them as they come up
365
382
366
383
**Artifact Management:**
384
+
367
385
- Use `create_file` for drafting full sections
368
386
- Use `str_replace` for all edits
369
387
- Provide artifact link after every change
370
388
- Never use artifacts for brainstorming lists - that's just conversation
371
389
372
390
**Quality over Speed:**
391
+
373
392
- Don't rush through stages
374
393
- Each iteration should make meaningful improvements
375
394
- The goal is a document that actually works for readers
Copy file name to clipboardExpand all lines: AGENTS.md
+4-1Lines changed: 4 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -63,15 +63,17 @@ The project uses `yarn` for dependency management and script execution.
63
63
When users ask you to perform tasks, check if any of the available skills below can help complete the task more effectively. Skills provide specialized capabilities and domain knowledge.
64
64
65
65
How to use skills:
66
+
66
67
- Invoke: Bash("openskills read <skill-name>")
67
68
- The skill content will load with detailed instructions on how to complete the task
68
69
- Base directory provided in output for resolving bundled resources (references/, scripts/, assets/)
69
70
70
71
Usage notes:
72
+
71
73
- Only use skills listed in <available_skills> below
72
74
- Do not invoke a skill that is already loaded in your context
0 commit comments