holycodex 0.16.9-dev.103.1 → 0.16.9-dev.106.1

package/dist/assets/plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "holycodex",
-  "version": "0.16.9",
+  "version": "0.16.9-1",
   "description": "Root-directed capabilities and deterministic installed assets for HolyCodex.",
   "author": {
     "name": "David Basile Filho",

package/dist/assets/plugin/skills/babysit-ci/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: babysit-ci
-description: Use when following CI or release gates through terminal completion.
+description: Use when CI or release gates need follow-through; monitor their terminal results and report gate evidence.
 ---
 
 # Babysit CI

package/dist/assets/plugin/skills/code-review/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: code-review
-description: Use after implementation when Root needs adversarial code review and bounded repair to a fixed point.
+description: Use when implementation is complete and Root needs adversarial code review; find defects and repair them within the assigned boundary until review reaches a fixed point.
 ---
 
 Inspect the integrated implementation against the `Reviewer.code` contract.

package/dist/assets/plugin/skills/codebase-onboarding/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: codebase-onboarding
-description: Use when explaining a repository or orienting a new contributor to how it works.
+description: Use when someone needs a repository explanation or contributor orientation; summarize its purpose, structure, and workflows from evidence.
 ---
 
 Provide a bounded, read-only orientation to the current repository or answer a

package/dist/assets/plugin/skills/commit/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: commit
-description: Use when Root creates a local commit after scope and proof are settled.
+description: Use when Root is ready to commit settled and verified work; create the smallest coherent commits that follow repository conventions.
 ---
 
 After scope and proof are settled, follow the repository's commit conventions

package/dist/assets/plugin/skills/compress/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: compress
-description: Use when assigned text must be shortened without changing its contract or voice.
+description: Use when assigned text must be shortened without changing its contract or voice; preserve meaning and constraints in a more concise version.
 ---
 
 Shorten only the assigned text. Preserve meaning, constraints, technical terms,

package/dist/assets/plugin/skills/context7-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: context7-cli
-description: Use when querying current technical documentation with Context7 CLI.
+description: Use when current technical documentation is needed through Context7 CLI; find the requested version-specific facts.
 ---
 
 Resolve the requested library identity with the installed ctx7 CLI, then query

package/dist/assets/plugin/skills/continue-work/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: continue-work
-description: Use when the user asks Root to continue, resume, or keep going with existing HolyCodex work.
+description: Use when the user asks Root to continue existing HolyCodex work; restore its current state and carry unresolved work forward.
 ---
 
 Restore the current Intent, Plan if present, Assignments, accepted evidence,

package/dist/assets/plugin/skills/debugging/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: debugging
-description: Use to diagnose and repair an observable defect or unexplained behavior.
+description: Use when an observable defect or unexplained behavior needs diagnosis; establish its cause and repair it within the assigned boundary.
 ---
 
 Reproduce the issue with the smallest useful case when practical; otherwise,

package/dist/assets/plugin/skills/grill-me/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: grill-me
-description: Use when an unspecified choice has multiple reasonable outcomes that could materially change the work.
+description: Use when an unspecified choice has multiple materially different outcomes; ask focused questions to resolve the decision before work depends on it.
 ---
 
 # Grill me

package/dist/assets/plugin/skills/handoff/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: handoff
-description: Use when a caller needs a redacted projection of current Intent state for resume or export.
+description: Use when current Intent state must be resumed or exported; produce a compact redacted status projection with evidence and next action.
 ---
 
 Produce one compact projection of current Intent, Plan, and Assignment status,

package/dist/assets/plugin/skills/operations/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: operations
-description: Use for a Worker.operations exact-ref/SHA observation Assignment.
+description: Use when assigned a Worker.operations observation of an exact ref and SHA; verify terminal gates and report evidence or blockers.
 ---
 
 Load [babysit-ci](../babysit-ci/SKILL.md) before observing the supplied exact ref

package/dist/assets/plugin/skills/plan/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: plan
-description: Use when unresolved architecture, scope, coordination, or material risk requires an implementation-ready Plan.
+description: Use when unresolved architecture, scope, coordination, or material risk needs resolution; produce an implementation-ready Plan with owners, seams, and proof.
 ---
 
 Resolve the current material choices into an implementation-ready Plan with

package/dist/assets/plugin/skills/plan-review/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: plan-review
-description: Use when a complete Plan needs adversarial feasibility, order, risk, and proof review.
+description: Use when a complete Plan needs adversarial review; assess feasibility, ordering, risk, and proof, then return findings and corrections.
 ---
 
 Inspect the complete Plan for feasibility, ordering, risk, and proof. Return

package/dist/assets/plugin/skills/programming/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: programming
-description: Use when Root has decided a bounded implementation seam with known acceptance behavior.
+description: Use when Root has decided a bounded implementation seam and its acceptance behavior; implement that seam and prove the required behavior.
 ---
 
 Implement only the decided seam and prove its acceptance behavior at the least

package/dist/assets/plugin/skills/refactor/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: refactor
-description: Use when one decided seam needs restructuring while preserving behavior and interfaces.
+description: Use when one decided seam needs restructuring without behavior or interface changes; refactor that seam and verify its boundaries.
 ---
 
 Restructure only the decided seam. Trace callers before changing a shared root

package/dist/assets/plugin/skills/rules/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rules
-description: Use when a repository rule needs discovery, validation, or diagnosis of an application failure.
+description: Use when a repository rule needs discovery, validation, or failure diagnosis; trace its owner and report the rule with evidence.
 ---
 
 Trace the owning rule loader and its limits, caching, trust boundary, and

package/dist/assets/plugin/skills/stop-slop/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: stop-slop
-description: Use when assigned prose should lose predictable AI writing patterns while preserving voice.
+description: Use when assigned prose has predictable AI writing patterns; remove them while preserving meaning and voice.
 ---
 
 Edit only the assigned prose. Remove filler, formulaic structure, vague claims,

package/dist/assets/plugin/skills/web-visualize/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: web-visualize
-description: Use when the user requests an interactive visualization or approves a proposed one.
+description: Use when the user requests or approves an interactive visualization; create a user-facing visual experience from the supplied material.
 ---
 
 Use ChatGPT Sites to create an interactive, user-facing visualization that

package/dist/assets/plugin/skills/writing-instructions/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: writing-instructions
-description: Use when authoring or reviewing model-facing instructions.
+description: Use when model-facing instructions need authorship or review; make them coherent, scoped, and complete for their receiver.
 ---
 
 # Writing instructions
@@ -23,6 +23,17 @@ in Role.task, and genuinely conditional workflow or tool knowledge in a skill.
 Generated projections derive from or validate against that owner. Invocation
 metadata selects a branch; it does not become a second policy source.
 
+Write instructions as short as possible without losing information that
+materially constrains correct behavior. Preserve known task facts, defects,
+distinctions, invariants, authority boundaries, required outcomes, and
+acceptance conditions; do not make the receiver rediscover relevant known
+facts. For implementation details that are not part of the contract and can be
+reliably discovered during execution, point toward the authoritative source
+instead of embedding them. Prefer generic guidance where the meaning is
+general. Name exact implementation details only when needed to locate
+authority, describe a known defect, preserve a distinction, or constrain exact
+behavior.
+
 Define the required outcome and completion evidence, bounded authority, relevant
 constraints, material decisions or blockers that escalate, and stopping
 conditions. Keep required lifecycle and safety invariants explicit. Give the
@@ -36,8 +47,20 @@ policy, and unnecessary questionnaires. Preserve meaningful repository checks
 and review gates through their canonical owners instead of reproducing them in
 every skill. Use configuration for verbosity rather than generic style padding.
 
-When changing a skill's invocation boundary or conditional branches, follow
-[Skill mechanics](SKILL-MECHANICS.md).
+Use a skill for a distinct conditional workflow or tool capability. Keep its
+description short and specific enough to distinguish the invocation from
+nearby skills. Avoid broad triggers that compete for ordinary work; audit
+implicit invocation against the other skills the receiver can load.
+
+Keep the main body focused on the shared outcome, boundaries, and acceptance
+criteria. Link branch-specific tool knowledge or uncommon procedures from the
+condition that needs them, so only the selected branch loads that detail. Do
+not split a short coherent rule merely to create more files.
+
+Keep display and invocation metadata in agents/openai.yaml and behavior in its
+single authoritative source. References should supply a missing decision or
+mechanic, not copies of the body or global policy. Preserve provenance and
+license attribution under the original upstream names when renaming a skill.
 
 An instruction change is complete when the receiver can act within its authority,
 recognize completion and escalation boundaries, and return sufficient evidence;