@zalom/plastic 1.10.0 → 1.11.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/README.md +1 -1
- package/package.json +1 -1
- package/skills/auto/references/human-report-contract.md +3 -5
- package/skills/conventions/references/tiers-and-dispatch.md +3 -3
- package/skills/humanizer/SKILL.md +0 -40
- package/skills/humanizer/evals/evals.json +0 -70
- package/skills/humanizer/references/always-on-snippet.md +0 -9
- package/skills/humanizer/references/examples.md +0 -48
package/README.md
CHANGED
|
@@ -139,7 +139,7 @@ Walk this once in
|
|
|
139
139
|
| Intent | `plastic-continuing`, `plastic-intent-creating`, `plastic-intent-starting`, `plastic-intent-brainstorming`, `plastic-intent-grilling`, `plastic-intent-speccing`, `plastic-intent-planning`, `plastic-intent-executing`, `plastic-intent-ending`, `plastic-intent-continuing`, `plastic-intent-researching` |
|
|
140
140
|
| Project and delivery | `plastic-project-creating`, `plastic-project-continuing`, `plastic-roadmap`, `plastic-roadmap-continuing`, `plastic-releasing` |
|
|
141
141
|
| Skill | `plastic-skill-creating`, `plastic-skill-evaluating` |
|
|
142
|
-
| Product | `plastic-install`, `plastic-update`, `plastic-uninstall`, `plastic-rollback`, `plastic-doctor
|
|
142
|
+
| Product | `plastic-install`, `plastic-update`, `plastic-uninstall`, `plastic-rollback`, `plastic-doctor` |
|
|
143
143
|
|
|
144
144
|
See [`docs/guides/index.md`](docs/guides/index.md) for task-oriented walkthroughs.
|
|
145
145
|
|
package/package.json
CHANGED
|
@@ -57,11 +57,9 @@ CONSUMES the intent 74 report to WRITE the human briefing defined here. The two
|
|
|
57
57
|
|
|
58
58
|
## Brevity: point, don't repeat
|
|
59
59
|
|
|
60
|
-
Surface rules
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
no rule of three, no hype words, no sycophancy, no over-bolding. Apply `plastic-humanizer` and the
|
|
64
|
-
always-on layer for everything else.
|
|
60
|
+
Surface rules are owned by the `writing-style` skill. This contract does not restate them, in full
|
|
61
|
+
or in summary. It defines the report's shape only: what to say, in what order, and when to stop.
|
|
62
|
+
Apply the `writing-style` skill for the wording.
|
|
65
63
|
|
|
66
64
|
## Emission: guided vs auto
|
|
67
65
|
|
|
@@ -130,6 +130,6 @@ succession at a glance (last line = where we are).
|
|
|
130
130
|
In auto mode the orchestrator briefs the human at every lifecycle stage boundary in a fixed,
|
|
131
131
|
impact-first shape (the EM-to-CTO report contract): State, then Risk, then Call. This is the
|
|
132
132
|
depth at M and L; at S the briefing fires once, at How. It leads with
|
|
133
|
-
what changed and why it matters, names one risk, and leaves the decision to the human.
|
|
134
|
-
the
|
|
135
|
-
|
|
133
|
+
what changed and why it matters, names one risk, and leaves the decision to the human. Wording
|
|
134
|
+
rules for the briefing, and for authored prose such as specs, outcomes, READMEs, and release
|
|
135
|
+
notes, are owned by the `writing-style` skill, not by this contract.
|
|
@@ -1,40 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: plastic-humanizer
|
|
3
|
-
description: Use to clean authored prose so it reads human and clutter-free. Removes AI tells and slop from a document, spec, outcome, README, report, or release note. Use when the user says "humanize", "de-slop", "remove the AI tells", or "clean up the wording". For documents, not for every chat reply, and not for code.
|
|
4
|
-
user-invocable: true
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Humanizer
|
|
8
|
-
|
|
9
|
-
Make writing read like a person wrote it: plain, direct, low-clutter. Run this as a pass over authored prose (specs, outcomes, README, reports). Do not run it on code or on every chat turn.
|
|
10
|
-
|
|
11
|
-
## Lead (house style)
|
|
12
|
-
Reframe your answers and any questions you have for me like you are speaking to a well-educated non-English native person. Reduce slang, and rarely used words and terms in the general communication. And cut all the fancy words from explanations. Technical terms and concepts are fine and need no gloss.
|
|
13
|
-
|
|
14
|
-
## Voice
|
|
15
|
-
Answer like a busy bartender or a senior support engineer who has seen almost every ticket. Help fast, give the fix first, earn the tip.
|
|
16
|
-
|
|
17
|
-
## Job 1 - remove these surface tells
|
|
18
|
-
1. Em-dashes and en-dashes - use a comma or a full stop.
|
|
19
|
-
2. "Not X but Y" (and "it's not just X, it's Y").
|
|
20
|
-
3. Rule of three - three items only for rhythm.
|
|
21
|
-
4. Hype / AI words - delve, robust, comprehensive, seamless, leverage, crucial, unlock, landscape.
|
|
22
|
-
5. Filler openers / signposting - "It's worth noting", "It's important to", "Let's dive in".
|
|
23
|
-
6. Hedging pile-up - might, could, perhaps, generally, when not needed.
|
|
24
|
-
7. Sycophancy - "Great question", "You're absolutely right".
|
|
25
|
-
8. Over-bolding - bold only what carries weight.
|
|
26
|
-
|
|
27
|
-
## Job 2 - fix the structure
|
|
28
|
-
- Lead with the one main point.
|
|
29
|
-
- Cut sentences that only restate.
|
|
30
|
-
- Pick concrete words over abstract ones.
|
|
31
|
-
- Match the user's voice when samples of their writing exist.
|
|
32
|
-
|
|
33
|
-
## Process
|
|
34
|
-
Write, check once against the rules above, then send. On documents, run this pass last.
|
|
35
|
-
|
|
36
|
-
## Length
|
|
37
|
-
Keep it short. If a sentence does not help the reader, cut it.
|
|
38
|
-
|
|
39
|
-
## More
|
|
40
|
-
For before/after examples, read `references/examples.md`. To make the house style always-on in chat, see `references/always-on-snippet.md`. The full 33-pattern catalog and the research behind this skill live in intent 92's `resources/`. They are background and are not loaded here.
|
|
@@ -1,70 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"skill_name": "plastic-humanizer",
|
|
3
|
-
"notes": "Intent 92. Cleans authored prose: removes 8 surface tells and applies structural levers (one point, cut restatement, concrete words, match voice). Triggers on document-cleanup asks, not on code. Runner is intent 76; assertions are human for now.",
|
|
4
|
-
"evals": [
|
|
5
|
-
{
|
|
6
|
-
"id": 1,
|
|
7
|
-
"scope": "trigger",
|
|
8
|
-
"set": "validation",
|
|
9
|
-
"prompt": "Humanize this README - it reads like AI wrote it.",
|
|
10
|
-
"expected_output": "Selects plastic-humanizer and runs the cleanup pass over the document.",
|
|
11
|
-
"files": [],
|
|
12
|
-
"assertions": [
|
|
13
|
-
{
|
|
14
|
-
"type": "human",
|
|
15
|
-
"check": "plastic-humanizer is selected for a document-cleanup request",
|
|
16
|
-
"observed": "description triggers on 'humanize' / 'reads like AI' for a document",
|
|
17
|
-
"result": "pass"
|
|
18
|
-
}
|
|
19
|
-
]
|
|
20
|
-
},
|
|
21
|
-
{
|
|
22
|
-
"id": 2,
|
|
23
|
-
"scope": "trigger",
|
|
24
|
-
"set": "validation",
|
|
25
|
-
"prompt": "Clean up the wording in this spec.",
|
|
26
|
-
"expected_output": "Selects plastic-humanizer and cleans the spec prose.",
|
|
27
|
-
"files": [],
|
|
28
|
-
"assertions": [
|
|
29
|
-
{
|
|
30
|
-
"type": "human",
|
|
31
|
-
"check": "plastic-humanizer is selected for 'clean up the wording'",
|
|
32
|
-
"observed": "description triggers on 'clean up the wording'",
|
|
33
|
-
"result": "pass"
|
|
34
|
-
}
|
|
35
|
-
]
|
|
36
|
-
},
|
|
37
|
-
{
|
|
38
|
-
"id": 3,
|
|
39
|
-
"scope": "non-trigger",
|
|
40
|
-
"set": "validation",
|
|
41
|
-
"prompt": "Fix the failing test in foo.rb.",
|
|
42
|
-
"expected_output": "Does NOT select plastic-humanizer; this is a code task, not prose cleanup.",
|
|
43
|
-
"files": [],
|
|
44
|
-
"assertions": [
|
|
45
|
-
{
|
|
46
|
-
"type": "human",
|
|
47
|
-
"check": "plastic-humanizer is not selected for a code task",
|
|
48
|
-
"observed": "description scopes the skill to documents, not code",
|
|
49
|
-
"result": "pass"
|
|
50
|
-
}
|
|
51
|
-
]
|
|
52
|
-
},
|
|
53
|
-
{
|
|
54
|
-
"id": 4,
|
|
55
|
-
"scope": "output",
|
|
56
|
-
"set": "validation",
|
|
57
|
-
"prompt": "Given a slop sample: 'It's worth noting that this is not just a fix, but a comprehensive, robust, and seamless improvement that will unlock real value.' Humanize it.",
|
|
58
|
-
"expected_output": "Cleaned text has no em-dashes and none of the 8 tells, leads with one point, and drops restatement. For example: 'This fix makes X faster.'",
|
|
59
|
-
"files": [],
|
|
60
|
-
"assertions": [
|
|
61
|
-
{
|
|
62
|
-
"type": "human",
|
|
63
|
-
"check": "output drops the 8 tells, leads with one point, cuts restatement",
|
|
64
|
-
"observed": "no em-dashes; no 'not X but Y'; no rule-of-three; no hype words; no filler opener; one load-bearing point",
|
|
65
|
-
"result": "pass"
|
|
66
|
-
}
|
|
67
|
-
]
|
|
68
|
-
}
|
|
69
|
-
]
|
|
70
|
-
}
|
|
@@ -1,9 +0,0 @@
|
|
|
1
|
-
# Always-on chat style (copy-paste)
|
|
2
|
-
|
|
3
|
-
Paste this into your global `CLAUDE.md` (applies to all projects) or a project `AGENTS.md` (one project). It keeps the chat style on at near-zero cost. The full cleanup for documents is the `plastic-humanizer` skill.
|
|
4
|
-
|
|
5
|
-
```
|
|
6
|
-
Reframe your answers and any questions like you are speaking to a well-educated person who is not a native English speaker. Reduce slang and rarely used words. Cut fancy words from explanations. Technical terms and concepts are fine.
|
|
7
|
-
|
|
8
|
-
Answer like a busy bartender or a senior support engineer who has seen almost every ticket: help fast, give the fix first, earn the tip.
|
|
9
|
-
```
|
|
@@ -1,48 +0,0 @@
|
|
|
1
|
-
# Examples - before and after
|
|
2
|
-
|
|
3
|
-
Each pair shows a tell or a slop pattern, then the fix.
|
|
4
|
-
|
|
5
|
-
## 1. Em-dash
|
|
6
|
-
Before: The release is ready - we just need sign-off.
|
|
7
|
-
After: The release is ready. We just need sign-off.
|
|
8
|
-
Why: Use a full stop or comma, not an em-dash.
|
|
9
|
-
|
|
10
|
-
## 2. "Not X but Y"
|
|
11
|
-
Before: This is not just a config change, it's a rethink of the flow.
|
|
12
|
-
After: This change reworks the flow.
|
|
13
|
-
Why: State the point directly.
|
|
14
|
-
|
|
15
|
-
## 3. Rule of three
|
|
16
|
-
Before: The tool is fast, robust, and powerful.
|
|
17
|
-
After: The tool is fast.
|
|
18
|
-
Why: Drop the list-for-rhythm; keep the claim you can back.
|
|
19
|
-
|
|
20
|
-
## 4. Hype / AI word
|
|
21
|
-
Before: We leverage a comprehensive caching layer to unlock performance.
|
|
22
|
-
After: We cache results to make it faster.
|
|
23
|
-
Why: Plain verbs and nouns.
|
|
24
|
-
|
|
25
|
-
## 5. Filler opener / signposting
|
|
26
|
-
Before: It's worth noting that the cache expires after five minutes.
|
|
27
|
-
After: The cache expires after five minutes.
|
|
28
|
-
Why: Say the thing; skip the runway.
|
|
29
|
-
|
|
30
|
-
## 6. Hedging pile-up
|
|
31
|
-
Before: This might possibly help reduce cost in some cases, generally.
|
|
32
|
-
After: This reduces cost.
|
|
33
|
-
Why: One clear claim. Add a caveat only if it is real.
|
|
34
|
-
|
|
35
|
-
## 7. Sycophancy
|
|
36
|
-
Before: Great question! That's a really insightful point. Here's the answer.
|
|
37
|
-
After: Here's the answer.
|
|
38
|
-
Why: Drop the praise; answer.
|
|
39
|
-
|
|
40
|
-
## 8. Structural fix (the mush)
|
|
41
|
-
Before: There are several important considerations to keep in mind when thinking about how best to approach the broad and multifaceted topic of caching, each of which carries its own trade-offs.
|
|
42
|
-
After: Cache reads, not writes. Reads repeat; writes do not.
|
|
43
|
-
Why: One load-bearing point. Cut the restatement and the abstract throat-clearing.
|
|
44
|
-
|
|
45
|
-
## 9. Over-bolding
|
|
46
|
-
Before: **Note:** the cache **expires** after **five minutes**, so **always** check it.
|
|
47
|
-
After: The cache expires after five minutes, so check it first.
|
|
48
|
-
Why: Bold nothing here; the sentence carries itself.
|