@holdyourvoice/hyv 3.3.5 → 3.4.0

package/skills/hyv-rebuild-writer-request/agent.json

@@ -0,0 +1,47 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-rebuild-writer-request",
+  "title": "hyv-rebuild-writer-request",
+  "description": "Create the writer-only payload for a prepared rebuild task.",
+  "instruction_file": "SKILL.md",
+  "role": "Writer-request author",
+  "workflow_phase": "plan",
+  "input": {
+    "required": [
+      "task.json",
+      "writer-request output path"
+    ],
+    "optional": []
+  },
+  "output": {
+    "required": [
+      "written writer-request.json"
+    ],
+    "optional": []
+  },
+  "evidence_requirements": [
+    "Report only the deterministic result the command returns; never invent a model or provider call that did not occur."
+  ],
+  "permissions": [
+    "execute_commands",
+    "read_repository",
+    "write_repository"
+  ],
+  "stop_conditions": [
+    "Stop when required input is missing, when the command cannot run without changing existing behavior, or when a claimed capability is unavailable."
+  ],
+  "tool_free_mode": {
+    "available": true,
+    "behavior": "Provide the decision, artifact template, and exact unavailable capability; never claim a tool action occurred.",
+    "unavailable_statuses": [
+      "NOT_AVAILABLE",
+      "NOT_CONFIGURED",
+      "NOT_RUN",
+      "STALE",
+      "ERROR"
+    ]
+  },
+  "handoff_to": [
+    "hyv-apply-rebuild"
+  ]
+}

package/skills/hyv-rebuild-writer-request/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Rebuild Writer Request"
+  short_description: "Create the writer-only payload for a prepared rebuild task."
+  default_prompt: "Use $hyv-rebuild-writer-request to create the writer-only payload for a prepared rebuild task."

package/skills/hyv-reduce-judgment/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-reduce-judgment
+description: Reduce bound judgment envelopes into SHIP, EDIT, REBUILD, CLEAR, or ESCALATE.
+---
+
+# hyv-reduce-judgment
+
+Reduce bound judgment envelopes into SHIP, EDIT, REBUILD, CLEAR, or ESCALATE. It does not call a model.
+
+## Usage
+
+```text
+hyv reduce-judgment envelope.json envelope.json envelope.json [envelope.json...]
+```
+
+## Behavior
+
+- Deterministic and local-first: this command never calls a provider and never sends drafts, samples, profiles, or telemetry to a service.
+- Commands that write use an explicit output path. Confirm that path before running the command.
+- This agent describes how to invoke the command and what it returns. It does not change command behavior or exit codes.
+
+## Handoff
+
+Run `hyv reduce-judgment` directly to execute the operation. Follow-on agents: hyv-prepare-rebuild.

package/skills/hyv-reduce-judgment/agent.json

@@ -0,0 +1,45 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-reduce-judgment",
+  "title": "hyv-reduce-judgment",
+  "description": "Reduce bound judgment envelopes into SHIP, EDIT, REBUILD, CLEAR, or ESCALATE.",
+  "instruction_file": "SKILL.md",
+  "role": "Judgment reducer",
+  "workflow_phase": "review",
+  "input": {
+    "required": [
+      "three or more judgment envelope.json paths"
+    ],
+    "optional": []
+  },
+  "output": {
+    "required": [
+      "reduced decision"
+    ],
+    "optional": []
+  },
+  "evidence_requirements": [
+    "Report only the deterministic result the command returns; never invent a model or provider call that did not occur."
+  ],
+  "permissions": [
+    "execute_commands",
+    "read_repository"
+  ],
+  "stop_conditions": [
+    "Stop when required input is missing, when the command cannot run without changing existing behavior, or when a claimed capability is unavailable."
+  ],
+  "tool_free_mode": {
+    "available": true,
+    "behavior": "Provide the decision, artifact template, and exact unavailable capability; never claim a tool action occurred.",
+    "unavailable_statuses": [
+      "NOT_AVAILABLE",
+      "NOT_CONFIGURED",
+      "NOT_RUN",
+      "STALE",
+      "ERROR"
+    ]
+  },
+  "handoff_to": [
+    "hyv-prepare-rebuild"
+  ]
+}

package/skills/hyv-reduce-judgment/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Reduce Judgment"
+  short_description: "Reduce bound judgment envelopes into SHIP, EDIT, REBUILD, CLEAR, or ESCALATE."
+  default_prompt: "Use $hyv-reduce-judgment to reduce bound judgment envelopes into ship, edit, rebuild, clear, or escalate."

package/skills/hyv-rewrite-prompt/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-rewrite-prompt
+description: Create a constrained editing brief without rewriting the draft.
+---
+
+# hyv-rewrite-prompt
+
+Create a constrained editing brief. It does not rewrite the draft or call a model. The brief is printed to stdout for redirect into a markdown file.
+
+## Usage
+
+```text
+hyv rewrite-prompt draft.md profile.json [writing-brief.json] > rewrite-brief.md
+```
+
+## Behavior
+
+- Deterministic and local-first: this command never calls a provider and never sends drafts, samples, profiles, or telemetry to a service.
+- Commands that write use an explicit output path. Confirm that path before running the command.
+- This agent describes how to invoke the command and what it returns. It does not change command behavior or exit codes.
+
+## Handoff
+
+Run `hyv rewrite-prompt` directly to execute the operation. Follow-on agents: hyv-prepare-rewrite.

package/skills/hyv-rewrite-prompt/agent.json

@@ -0,0 +1,48 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-rewrite-prompt",
+  "title": "hyv-rewrite-prompt",
+  "description": "Create a constrained editing brief without rewriting the draft.",
+  "instruction_file": "SKILL.md",
+  "role": "Brief author",
+  "workflow_phase": "plan",
+  "input": {
+    "required": [
+      "draft path",
+      "profile path"
+    ],
+    "optional": [
+      "writing-brief.json"
+    ]
+  },
+  "output": {
+    "required": [
+      "markdown editing brief"
+    ],
+    "optional": []
+  },
+  "evidence_requirements": [
+    "Report only the deterministic result the command returns; never invent a model or provider call that did not occur."
+  ],
+  "permissions": [
+    "execute_commands",
+    "read_repository"
+  ],
+  "stop_conditions": [
+    "Stop when required input is missing, when the command cannot run without changing existing behavior, or when a claimed capability is unavailable."
+  ],
+  "tool_free_mode": {
+    "available": true,
+    "behavior": "Provide the decision, artifact template, and exact unavailable capability; never claim a tool action occurred.",
+    "unavailable_statuses": [
+      "NOT_AVAILABLE",
+      "NOT_CONFIGURED",
+      "NOT_RUN",
+      "STALE",
+      "ERROR"
+    ]
+  },
+  "handoff_to": [
+    "hyv-prepare-rewrite"
+  ]
+}

package/skills/hyv-rewrite-prompt/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Rewrite Prompt"
+  short_description: "Create a constrained editing brief without rewriting the draft."
+  default_prompt: "Use $hyv-rewrite-prompt to create a constrained editing brief without rewriting the draft."

package/skills/hyv-verify/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-verify
+description: Verify a revised candidate against an original draft and portable profile.
+---
+
+# hyv-verify
+
+Verify a revised candidate against an original draft and portable profile without changing learning state. Verification is read-only; learning changes require an explicit learning command or a separately approved lifecycle transition.
+
+## Usage
+
+```text
+hyv verify original.md candidate.md profile.json [writing-brief.json]
+```
+
+## Behavior
+
+- Deterministic and local-first: this command never calls a provider and never sends drafts, samples, profiles, or telemetry to a service.
+- Commands that write use an explicit output path. Confirm that path before running the command.
+- This agent describes how to invoke the command and what it returns. It does not change command behavior or exit codes.
+
+## Handoff
+
+Run `hyv verify` directly to execute the operation. Follow-on agents: hyv-lifecycle.

package/skills/hyv-verify/agent.json

@@ -0,0 +1,49 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-verify",
+  "title": "hyv-verify",
+  "description": "Verify a revised candidate against an original draft and portable profile.",
+  "instruction_file": "SKILL.md",
+  "role": "Verifier",
+  "workflow_phase": "verify",
+  "input": {
+    "required": [
+      "original path",
+      "candidate path",
+      "profile path"
+    ],
+    "optional": [
+      "writing-brief.json"
+    ]
+  },
+  "output": {
+    "required": [
+      "verification report"
+    ],
+    "optional": []
+  },
+  "evidence_requirements": [
+    "Report only the deterministic result the command returns; never invent a model or provider call that did not occur."
+  ],
+  "permissions": [
+    "execute_commands",
+    "read_repository"
+  ],
+  "stop_conditions": [
+    "Stop when required input is missing, when the command cannot run without changing existing behavior, or when a claimed capability is unavailable."
+  ],
+  "tool_free_mode": {
+    "available": true,
+    "behavior": "Provide the decision, artifact template, and exact unavailable capability; never claim a tool action occurred.",
+    "unavailable_statuses": [
+      "NOT_AVAILABLE",
+      "NOT_CONFIGURED",
+      "NOT_RUN",
+      "STALE",
+      "ERROR"
+    ]
+  },
+  "handoff_to": [
+    "hyv-lifecycle"
+  ]
+}

package/skills/hyv-verify/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Verify"
+  short_description: "Verify a revised candidate against an original draft and portable profile."
+  default_prompt: "Use $hyv-verify to verify a revised candidate against an original draft and portable profile."

package/skills/hyv-verify-spec/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-verify-spec
+description: Verify a candidate against the existing voice gates and a local CopySpec.
+---
+
+# hyv-verify-spec
+
+Verify a candidate against the existing voice gates and a local CopySpec. Immutable claims remain verbatim unless atoms are supplied; then each declared atom must remain. Prohibited claims fail closed.
+
+## Usage
+
+```text
+hyv verify-spec original.md candidate.md profile.json copy-spec.json [writing-brief.json]
+```
+
+## Behavior
+
+- Deterministic and local-first: this command never calls a provider and never sends drafts, samples, profiles, or telemetry to a service.
+- Commands that write use an explicit output path. Confirm that path before running the command.
+- This agent describes how to invoke the command and what it returns. It does not change command behavior or exit codes.
+
+## Handoff
+
+Run `hyv verify-spec` directly to execute the operation. Follow-on agents: hyv-lifecycle.

package/skills/hyv-verify-spec/agent.json

@@ -0,0 +1,50 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-verify-spec",
+  "title": "hyv-verify-spec",
+  "description": "Verify a candidate against the existing voice gates and a local CopySpec.",
+  "instruction_file": "SKILL.md",
+  "role": "CopySpec verifier",
+  "workflow_phase": "verify",
+  "input": {
+    "required": [
+      "original path",
+      "candidate path",
+      "profile path",
+      "copy-spec.json"
+    ],
+    "optional": [
+      "writing-brief.json"
+    ]
+  },
+  "output": {
+    "required": [
+      "verification report with CopySpec claim gate"
+    ],
+    "optional": []
+  },
+  "evidence_requirements": [
+    "Report only the deterministic result the command returns; never invent a model or provider call that did not occur."
+  ],
+  "permissions": [
+    "execute_commands",
+    "read_repository"
+  ],
+  "stop_conditions": [
+    "Stop when required input is missing, when the command cannot run without changing existing behavior, or when a claimed capability is unavailable."
+  ],
+  "tool_free_mode": {
+    "available": true,
+    "behavior": "Provide the decision, artifact template, and exact unavailable capability; never claim a tool action occurred.",
+    "unavailable_statuses": [
+      "NOT_AVAILABLE",
+      "NOT_CONFIGURED",
+      "NOT_RUN",
+      "STALE",
+      "ERROR"
+    ]
+  },
+  "handoff_to": [
+    "hyv-lifecycle"
+  ]
+}

package/skills/hyv-verify-spec/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Verify Spec"
+  short_description: "Verify a candidate against the existing voice gates and a local CopySpec."
+  default_prompt: "Use $hyv-verify-spec to verify a candidate against the existing voice gates and a local copyspec."