docrev 0.5.1 → 0.5.2

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 (2) hide show
  1. package/package.json +1 -1
  2. package/skill/SKILL.md +16 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "docrev",
3
- "version": "0.5.1",
3
+ "version": "0.5.2",
4
4
  "description": "Academic paper revision workflow: Word ↔ Markdown round-trips, DOI validation, reviewer comments",
5
5
  "type": "module",
6
6
  "types": "types/index.d.ts",
package/skill/SKILL.md CHANGED
@@ -134,4 +134,20 @@ my-paper/
134
134
  4. **Validation phase**: Run `rev check` before submission (lint + grammar + citations)
135
135
  5. **Response letter**: Use `rev response` to generate point-by-point responses
136
136
 
137
+ ## Critical: Ask Questions When Unsure
138
+
139
+ When addressing reviewer comments or editing scientific papers:
140
+
141
+ - **Never guess methods or numbers** - If a comment asks for clarification about methodology, sample sizes, statistical parameters, dates, or any quantitative information, ASK the user rather than inventing values
142
+ - **Placeholders are acceptable** - Use `[???]` or `[TODO: specify X]` when information is missing rather than fabricating data
143
+ - **Search online for references** - When comments request citations, use web search to find appropriate references rather than guessing
144
+ - **Clarify ambiguous requests** - If a reviewer comment could be interpreted multiple ways, ask the user which interpretation they prefer
145
+ - **Verify existing values** - When editing numbers that already exist in the document, confirm changes with the user if there's any doubt
146
+
147
+ Example scenarios requiring user input:
148
+ - "Add a reference for this claim" → Search online OR ask user for specific citation
149
+ - "Clarify the sample size" → Ask user for the correct number
150
+ - "Specify the statistical test used" → Ask user which test was actually used
151
+ - "Add the date of data collection" → Ask user for the actual date
152
+
137
153
  For complete command reference, see [REFERENCE.md](REFERENCE.md).