docupuncture 0.1.4 → 0.1.6
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/README.md +3 -3
- package/package.json +1 -1
- package/skills/docupuncture-docs/SKILL.md +9 -9
- package/skills/docupuncture-docs/references/sample-skeleton.js +1 -1
- package/skills/docupuncture-sheets/SKILL.md +7 -7
- package/skills/docupuncture-sheets/SKILL_FACTS.md +1 -1
- package/skills/docupuncture-sheets/references/sample-skeleton.js +1 -1
- package/skills/docupuncture-slides/SKILL.md +7 -7
- package/skills/docupuncture-slides/SKILL_FACTS.md +1 -1
- package/skills/docupuncture-slides/references/sample-skeleton.js +1 -1
package/README.md
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
|
-
#
|
|
1
|
+
# DocuPuncture
|
|
2
2
|
|
|
3
3
|
Treat the document you already have.
|
|
4
4
|
|
|
5
5
|
Insert precise edits without changing the theme, format, comments, or history.
|
|
6
6
|
|
|
7
|
-
When an AI regenerates a Google Doc, Sheet, or deck, those things usually go with it.
|
|
7
|
+
When an AI regenerates a Google Doc, Sheet, or deck, those things usually go with it. DocuPuncture writes a small Apps Script you paste and run on the live file.
|
|
8
8
|
|
|
9
9
|
## The skills
|
|
10
10
|
|
|
@@ -44,7 +44,7 @@ The script is safe to re-run. Missing anchors are logged. It never invents a loc
|
|
|
44
44
|
|
|
45
45
|
The other tools in the shop strike, press, or contain. A needle is still metal from the same fire, but you don't swing it. You place it.
|
|
46
46
|
|
|
47
|
-
Acupuncture treats a living body in place: insert at a point, leave the rest alone.
|
|
47
|
+
Acupuncture treats a living body in place: insert at a point, leave the rest alone. DocuPuncture does that to a document you already care about.
|
|
48
48
|
|
|
49
49
|
Closest cousin on the shelf is [TemperPass](https://temperpass.dev): a rule set you point an agent at.
|
|
50
50
|
|
package/package.json
CHANGED
|
@@ -1,32 +1,32 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: docupuncture-docs
|
|
3
|
-
description: Precise in-place edits to an existing Google Doc via paste-and-run Apps Script. Use when the user wants edits, tweaks, or iterations to a Google Doc (or says "
|
|
3
|
+
description: Precise in-place edits to an existing Google Doc via paste-and-run Apps Script. Use when the user wants edits, tweaks, or iterations to a Google Doc (or says "DocuPuncture") — deliver a self-contained script that patches the live doc while preserving all formatting, instead of regenerating a new document. Prefer this over full regeneration for formatted docs. Part of the DocuPuncture family (Docs, Sheets, Slides).
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
#
|
|
6
|
+
# DocuPuncture for Docs
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
DocuPuncture = insert precise edits without changing the theme, format, comments, or history. This skill is the **Docs** implementation.
|
|
9
9
|
|
|
10
|
-
Deliver edits as a self-contained Apps Script the user pastes into Extensions → Apps Script and runs, instead of regenerating a new document. In-place patching preserves all formatting (fonts, colors, images, tables, comments, theme) that API imports and full regenerations destroy. Use the name "
|
|
10
|
+
Deliver edits as a self-contained Apps Script the user pastes into Extensions → Apps Script and runs, instead of regenerating a new document. In-place patching preserves all formatting (fonts, colors, images, tables, comments, theme) that API imports and full regenerations destroy. Use the name "DocuPuncture" when referring to this workflow with the user.
|
|
11
11
|
|
|
12
12
|
|
|
13
13
|
## When to offer
|
|
14
14
|
|
|
15
15
|
Whenever the user asks for edits, tweaks, or iterations to an existing Google Doc — especially repeated iteration rounds — use AskUserQuestion to offer:
|
|
16
16
|
|
|
17
|
-
1. **
|
|
17
|
+
1. **DocuPuncture: Apps Script patch** (recommended for formatted docs) — I generate a script; you run it once. Formatting preserved. First run requires a one-time authorization prompt.
|
|
18
18
|
2. **New generated doc** — full regeneration (warn: loses theme/logo/comments).
|
|
19
19
|
3. **Manual edit checklist** — exact paste-ready text.
|
|
20
20
|
|
|
21
|
-
Skip the question and go straight to the script if the user says "
|
|
21
|
+
Skip the question and go straight to the script if the user says "DocuPuncture" or has already established this preference in the conversation.
|
|
22
22
|
|
|
23
23
|
### Edit volume / risk guidance
|
|
24
24
|
|
|
25
25
|
Before generating the script, quickly assess the size and nature of the requested changes:
|
|
26
26
|
|
|
27
|
-
- **Low risk** (1–5 discrete edits, mostly text swaps or simple inserts/deletes): proceed with pure
|
|
28
|
-
- **Medium risk** (6–10 edits or light structural work): still prefer
|
|
29
|
-
- **High risk** (>10 discrete edits, major restructuring, multi-section moves, or many interdependent changes): strongly recommend breaking into multiple sequential
|
|
27
|
+
- **Low risk** (1–5 discrete edits, mostly text swaps or simple inserts/deletes): proceed with pure DocuPuncture.
|
|
28
|
+
- **Medium risk** (6–10 edits or light structural work): still prefer DocuPuncture, but warn the user that a fresh re-read of the doc is required if they make manual changes between runs, and consider splitting into two smaller scripts if the anchors feel fragile.
|
|
29
|
+
- **High risk** (>10 discrete edits, major restructuring, multi-section moves, or many interdependent changes): strongly recommend breaking into multiple sequential DocuPuncture rounds, or switching to a full regeneration / hybrid approach. Do not force a single massive script.
|
|
30
30
|
|
|
31
31
|
If the set of changes is high-risk, surface this explicitly to the user before writing the script.
|
|
32
32
|
|
|
@@ -1,27 +1,27 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: docupuncture-sheets
|
|
3
|
-
description: Precise in-place edits to an existing Google Sheet via paste-and-run Apps Script. Use when the user wants edits, tweaks, or iterations to a Google Sheet (or says "
|
|
3
|
+
description: Precise in-place edits to an existing Google Sheet via paste-and-run Apps Script. Use when the user wants edits, tweaks, or iterations to a Google Sheet (or says "DocuPuncture" in a sheets context) — deliver a self-contained script that patches the live spreadsheet while preserving formatting, notes, data validation, and structure, instead of regenerating a new sheet.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
#
|
|
6
|
+
# DocuPuncture for Sheets
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
DocuPuncture applied to Google Sheets: insert precise edits without changing the theme, format, comments, or history. Notes, data validation, charts, and structure stay too. Deliver edits as a self-contained Apps Script the user pastes into Extensions → Apps Script and runs.
|
|
9
9
|
|
|
10
|
-
Use the name "
|
|
10
|
+
Use the name "DocuPuncture" (or "DocuPuncture on this sheet") when referring to this workflow.
|
|
11
11
|
|
|
12
12
|
## When to offer
|
|
13
13
|
|
|
14
14
|
Whenever the user asks for edits, tweaks, or iterations to an existing Google Sheet — especially repeated rounds — offer:
|
|
15
15
|
|
|
16
|
-
1. **
|
|
16
|
+
1. **DocuPuncture: Apps Script patch** (recommended) — I generate a script; you run it once. Formatting, notes, and validation preserved.
|
|
17
17
|
2. **New generated sheet** — full regeneration (warn: loses most formatting, notes, validation, charts).
|
|
18
18
|
3. **Manual edit checklist** — exact values/ranges to change.
|
|
19
19
|
|
|
20
|
-
Skip the question if the user already said "
|
|
20
|
+
Skip the question if the user already said "DocuPuncture" or established the preference.
|
|
21
21
|
|
|
22
22
|
### Edit volume / risk guidance
|
|
23
23
|
|
|
24
|
-
- **Low risk** (1–6 discrete cell/range updates): pure
|
|
24
|
+
- **Low risk** (1–6 discrete cell/range updates): pure DocuPuncture.
|
|
25
25
|
- **Medium risk** (7–12 updates or light structural work such as inserting a few rows): still preferred, but warn about anchor drift.
|
|
26
26
|
- **High risk** (large structural changes, many interdependent formulas, or wholesale table rewrites): recommend sequential smaller scripts or full regeneration.
|
|
27
27
|
|
|
@@ -80,4 +80,4 @@ Precise in-place edits to an existing Google Sheet via paste-and-run Apps Script
|
|
|
80
80
|
---
|
|
81
81
|
*Generated with [SkillFacts](https://skillfacts.dev) · Built by [Catalyst Forge](https://www.catalystforge.com/)*
|
|
82
82
|
|
|
83
|
-
[skillfacts-label]: https://skillfacts.dev/v#sf1.
|
|
83
|
+
[skillfacts-label]: https://skillfacts.dev/v#sf1.eNqdUkFuGzEM_Iqgs9eOe_QtcNFeEiBAjkFgyBK9K1hLCiS1TRDk76UWDepDT70Jo9FwZqgPv_jDfuMxzOAPPlFstWHUxjDIBKDiNz7BAoUqsDGOQUN5F3U_iEewywVYMqFd3W33270hokGbGBCi5qVzSo6A0gfc1xAnGL5t7wy-ZkyGxcZCPMg1l2JobVxpJT8xxCzgMg61hAgOUlZxSi6gg7csmnF0P4nGAu65u3VLDq4GURgCpoEbuvtaxT1HzlW7ONMCGDCa_ocXatxPflKtctjtxqxTO28jzbuvoMMadHh4OO5u21mNnku2kv5Ry-fGZxTlZg0QyonBYq8TJ7CQB4-EXQJBfxFfDchzLRmSYZdcQEwK5i-eqSlR6TIXYDDzVtuL_xP8O1vJ7vH45GxKOvXnp0iogOpfN_7cMBVIp8CaL7YRW8yLwTAyiHRLCgVmUH7_aytBrzas3jvdDEw0Qw3jbVm3dWztj9hDBltdVlrF_qtU6wxj0J7QjvD5G3Sx7BI
|
|
@@ -1,27 +1,27 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: docupuncture-slides
|
|
3
|
-
description: Precise in-place edits to an existing Google Slides presentation via paste-and-run Apps Script. Use when the user wants edits, tweaks, or iterations to a Google Slides deck (or says "
|
|
3
|
+
description: Precise in-place edits to an existing Google Slides presentation via paste-and-run Apps Script. Use when the user wants edits, tweaks, or iterations to a Google Slides deck (or says "DocuPuncture" in a slides context) — deliver a self-contained script that patches the live presentation while preserving layout, styles, and structure, instead of regenerating a new deck.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
#
|
|
6
|
+
# DocuPuncture for Slides
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
DocuPuncture applied to Google Slides: insert precise edits without changing the theme, format, comments, or history. Layout and speaker notes stay too. Deliver edits as a self-contained Apps Script the user pastes into Extensions → Apps Script and runs.
|
|
9
9
|
|
|
10
|
-
Use the name "
|
|
10
|
+
Use the name "DocuPuncture" (or "DocuPuncture on these slides") when referring to this workflow.
|
|
11
11
|
|
|
12
12
|
## When to offer
|
|
13
13
|
|
|
14
14
|
Whenever the user asks for edits, tweaks, or iterations to an existing Google Slides presentation — especially repeated rounds — offer:
|
|
15
15
|
|
|
16
|
-
1. **
|
|
16
|
+
1. **DocuPuncture: Apps Script patch** (recommended for content/text changes) — I generate a script; you run it once. Layout and theme preserved.
|
|
17
17
|
2. **New generated deck** — full regeneration (warn: loses theme, precise positioning, speaker notes, etc.).
|
|
18
18
|
3. **Manual edit checklist** — exact text or slide-by-slide changes.
|
|
19
19
|
|
|
20
|
-
Skip the question if the user already said "
|
|
20
|
+
Skip the question if the user already said "DocuPuncture" or established the preference.
|
|
21
21
|
|
|
22
22
|
### Edit volume / risk guidance
|
|
23
23
|
|
|
24
|
-
- **Low risk** (1–6 text replacements or simple content updates on existing shapes): pure
|
|
24
|
+
- **Low risk** (1–6 text replacements or simple content updates on existing shapes): pure DocuPuncture.
|
|
25
25
|
- **Medium risk** (7–12 changes or light additions of text boxes): still preferred.
|
|
26
26
|
- **High risk** (major layout restructuring, many new slides, complex object insertion/repositioning): recommend sequential smaller scripts or full regeneration. Positioning is fragile.
|
|
27
27
|
|
|
@@ -80,4 +80,4 @@ Precise in-place edits to an existing Google Slides deck via paste-and-run Apps
|
|
|
80
80
|
---
|
|
81
81
|
*Generated with [SkillFacts](https://skillfacts.dev) · Built by [Catalyst Forge](https://www.catalystforge.com/)*
|
|
82
82
|
|
|
83
|
-
[skillfacts-label]: https://skillfacts.dev/v#sf1.
|
|
83
|
+
[skillfacts-label]: https://skillfacts.dev/v#sf1.eNqdkjFvGzEMhf-KoNlnxx29BS7aJQECZAwCQ5boO8I6SiCpa4Ig_73UoUE9dOomPFHkex_14Rd_2G88hRn8wacSW20UtTEMkjGB-I1PsEAuFdgqjkFDfhd1PwqPYJcLsGAhu7rb7rd7U0SDNjEhRMWl12SMQNIH3NcQJxi-be9MviIl02JjKTzIFXM2tTauZS1-Yogo4JCGmkMEBwlVnBYXyMEbiiKN7mcpYwb3vLp1CeLVLRhcDaIwBEoDN3L3tYp7joxV-wguC1CgaFM-vJTG_eQn1SqH3W5Endp5G8u8-4o7rHGHh4fj7pbRavecUaZ_wfnceCRRbsahkJwYLPw6cQKLevBUqLcg0F-FrybgXDNCMu2CGcRawfxVZ920lNzbXIDBzBu8F_8n_nc21O7x-ORsSjr156dYSIHUv278uVHKkE6BFS-2F1vPi8kwMoh0SwoZZlB-_2vLcBrgsHrv5WZgKjPUMN7CusWxtZ9iDxlsgahlbfZfUI0ZxaA9oR3h8zfqbO4s
|