tribunal-kit 2.4.2 → 2.4.3

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 (8) hide show
  1. package/.agent/scripts/patch_skills_meta.py +177 -177
  2. package/.agent/scripts/patch_skills_output.py +285 -285
  3. package/.agent/scripts/strengthen_skills.py +220 -220
  4. package/.agent/skills/github-operations/SKILL.md +354 -354
  5. package/.agent/skills/readme-builder/SKILL.md +270 -270
  6. package/.agent/workflows/strengthen-skills.md +99 -99
  7. package/bin/tribunal-kit.js +547 -542
  8. package/package.json +53 -38
package/.agent/workflows/strengthen-skills.md CHANGED
@@ -1,99 +1,99 @@
1
- ---
2
- description: Strengthen skills by appending Tribunal guardrails (LLM Traps, Pre-Flight checklist, VBC Protocol) to any SKILL.md missing them.
3
- ---
4
-
5
- # /strengthen-skills Workflow
6
-
7
- Use this command to audit and harden all skills in `.agent/skills/` that are missing
8
- the standard Tribunal guardrails block.
9
-
10
- ---
11
-
12
- ## What It Does
13
-
14
- Runs `strengthen_skills.py` against all skill files.
15
- For each skill it checks:
16
-
17
- 1. **Tribunal Integration section** — does it have `🏛️ Tribunal Integration`?
18
- 2. **VBC Protocol** — does it have `Verification-Before-Completion`?
19
-
20
- Skills missing either are strengthened by appending the full canonical block:
21
- - `## 🤖 LLM-Specific Traps`
22
- - `## 🏛️ Tribunal Integration (Anti-Hallucination)`
23
- - Forbidden AI Tropes
24
- - Pre-Flight Self-Audit checklist
25
- - VBC Protocol
26
-
27
- Skills that already have both sections are skipped automatically.
28
-
29
- ---
30
-
31
- ## Steps
32
-
33
- ### Step 1 — Dry Run (Always First)
34
-
35
- ```powershell
36
- python .agent/scripts/strengthen_skills.py . --dry-run
37
- ```
38
-
39
- Review the output. All lines prefixed with `⚠️ [DRY RUN]` are skills that would be strengthened.
40
-
41
- > **Human Gate:** If the dry-run output looks correct, continue to Step 2.
42
- > If unexpected skills are listed, investigate before proceeding.
43
-
44
- ---
45
-
46
- ### Step 2 — Strengthen All Skills
47
-
48
- ```powershell
49
- python .agent/scripts/strengthen_skills.py .
50
- ```
51
-
52
- ---
53
-
54
- ### Step 3 — Verify Summary
55
-
56
- The script prints a final summary:
57
- ```
58
- ✅ Strengthened: N
59
- ⏭️ Skipped: N
60
- ❌ Errors: 0
61
- ```
62
-
63
- Errors must be zero before proceeding. If any errors appear, fix them and re-run.
64
-
65
- ---
66
-
67
- ### Step 4 — Strengthen a Single Skill (Optional)
68
-
69
- To strengthen one specific skill only:
70
-
71
- ```powershell
72
- python .agent/scripts/strengthen_skills.py . --skill <skill-name>
73
- ```
74
-
75
- Example:
76
- ```powershell
77
- python .agent/scripts/strengthen_skills.py . --skill brainstorming
78
- ```
79
-
80
- ---
81
-
82
- ### Step 5 — Custom Skills Directory (Optional)
83
-
84
- If skills live in a non-standard location:
85
-
86
- ```powershell
87
- python .agent/scripts/strengthen_skills.py . --skills-path /path/to/skills
88
- ```
89
-
90
- ---
91
-
92
- ## Related Commands
93
-
94
- | Command | Purpose |
95
- |---|---|
96
- | `/audit` | Full project health audit (includes skills review) |
97
- | `python .agent/scripts/patch_skills_meta.py .` | Inject version/freshness metadata into frontmatter |
98
- | `python .agent/scripts/patch_skills_output.py .` | Add Output Format sections to skills missing them |
99
- | `python .agent/scripts/config_validator.py .` | Validate all agent config consistency |
1
+ ---
2
+ description: Strengthen skills by appending Tribunal guardrails (LLM Traps, Pre-Flight checklist, VBC Protocol) to any SKILL.md missing them.
3
+ ---
4
+
5
+ # /strengthen-skills Workflow
6
+
7
+ Use this command to audit and harden all skills in `.agent/skills/` that are missing
8
+ the standard Tribunal guardrails block.
9
+
10
+ ---
11
+
12
+ ## What It Does
13
+
14
+ Runs `strengthen_skills.py` against all skill files.
15
+ For each skill it checks:
16
+
17
+ 1. **Tribunal Integration section** — does it have `🏛️ Tribunal Integration`?
18
+ 2. **VBC Protocol** — does it have `Verification-Before-Completion`?
19
+
20
+ Skills missing either are strengthened by appending the full canonical block:
21
+ - `## 🤖 LLM-Specific Traps`
22
+ - `## 🏛️ Tribunal Integration (Anti-Hallucination)`
23
+ - Forbidden AI Tropes
24
+ - Pre-Flight Self-Audit checklist
25
+ - VBC Protocol
26
+
27
+ Skills that already have both sections are skipped automatically.
28
+
29
+ ---
30
+
31
+ ## Steps
32
+
33
+ ### Step 1 — Dry Run (Always First)
34
+
35
+ ```powershell
36
+ python .agent/scripts/strengthen_skills.py . --dry-run
37
+ ```
38
+
39
+ Review the output. All lines prefixed with `⚠️ [DRY RUN]` are skills that would be strengthened.
40
+
41
+ > **Human Gate:** If the dry-run output looks correct, continue to Step 2.
42
+ > If unexpected skills are listed, investigate before proceeding.
43
+
44
+ ---
45
+
46
+ ### Step 2 — Strengthen All Skills
47
+
48
+ ```powershell
49
+ python .agent/scripts/strengthen_skills.py .
50
+ ```
51
+
52
+ ---
53
+
54
+ ### Step 3 — Verify Summary
55
+
56
+ The script prints a final summary:
57
+ ```
58
+ ✅ Strengthened: N
59
+ ⏭️ Skipped: N
60
+ ❌ Errors: 0
61
+ ```
62
+
63
+ Errors must be zero before proceeding. If any errors appear, fix them and re-run.
64
+
65
+ ---
66
+
67
+ ### Step 4 — Strengthen a Single Skill (Optional)
68
+
69
+ To strengthen one specific skill only:
70
+
71
+ ```powershell
72
+ python .agent/scripts/strengthen_skills.py . --skill <skill-name>
73
+ ```
74
+
75
+ Example:
76
+ ```powershell
77
+ python .agent/scripts/strengthen_skills.py . --skill brainstorming
78
+ ```
79
+
80
+ ---
81
+
82
+ ### Step 5 — Custom Skills Directory (Optional)
83
+
84
+ If skills live in a non-standard location:
85
+
86
+ ```powershell
87
+ python .agent/scripts/strengthen_skills.py . --skills-path /path/to/skills
88
+ ```
89
+
90
+ ---
91
+
92
+ ## Related Commands
93
+
94
+ | Command | Purpose |
95
+ |---|---|
96
+ | `/audit` | Full project health audit (includes skills review) |
97
+ | `python .agent/scripts/patch_skills_meta.py .` | Inject version/freshness metadata into frontmatter |
98
+ | `python .agent/scripts/patch_skills_output.py .` | Add Output Format sections to skills missing them |
99
+ | `python .agent/scripts/config_validator.py .` | Validate all agent config consistency |