@holdyourvoice/hyv 3.3.4 → 3.4.0

package/skills/hyv-analyze/agent.json

@@ -0,0 +1,49 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-analyze",
+  "title": "hyv-analyze",
+  "description": "Run separate VoiceDNA and AI Editor checks plus a non-scoring Unicode hygiene inspection against a draft.",
+  "instruction_file": "SKILL.md",
+  "role": "Analyzer",
+  "workflow_phase": "analyze",
+  "input": {
+    "required": [
+      "draft path",
+      "profile path"
+    ],
+    "optional": [
+      "writing-brief.json"
+    ]
+  },
+  "output": {
+    "required": [
+      "combined analysis 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-rewrite-prompt",
+    "hyv-prepare-rewrite"
+  ]
+}

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

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Analyze"
+  short_description: "Run separate VoiceDNA and AI Editor checks plus a non-scoring Unicode hygiene inspection against a draft."
+  default_prompt: "Use $hyv-analyze to run separate voicedna and ai editor checks plus a non-scoring unicode hygiene inspection against a draft."

package/skills/hyv-apply-hidden-text-policy/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-apply-hidden-text-policy
+description: Apply only explicitly approved minimal hidden-text removals and return hashes, exact changes, and remaining findings.
+---
+
+# hyv-apply-hidden-text-policy
+
+Apply only explicitly approved minimal hidden-text removals and return hashes, exact changes, and remaining review findings. The output must differ from the input path. This never invents removals beyond the approved policy.
+
+## Usage
+
+```text
+hyv apply-hidden-text-policy draft.md policy.json output.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 apply-hidden-text-policy` directly to execute the operation. Follow-on agents: hyv-final-check.

package/skills/hyv-apply-hidden-text-policy/agent.json

@@ -0,0 +1,49 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-apply-hidden-text-policy",
+  "title": "hyv-apply-hidden-text-policy",
+  "description": "Apply only explicitly approved minimal hidden-text removals and return hashes, exact changes, and remaining findings.",
+  "instruction_file": "SKILL.md",
+  "role": "Hidden-text editor",
+  "workflow_phase": "edit",
+  "input": {
+    "required": [
+      "draft path",
+      "policy path",
+      "output path"
+    ],
+    "optional": []
+  },
+  "output": {
+    "required": [
+      "written output.md",
+      "change 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",
+    "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-final-check"
+  ]
+}

package/skills/hyv-apply-hidden-text-policy/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Apply Hidden Text Policy"
+  short_description: "Apply only explicitly approved minimal hidden-text removals and return hashes, exact changes, and remaining findings."
+  default_prompt: "Use $hyv-apply-hidden-text-policy to apply only explicitly approved minimal hidden-text removals and return hashes, exact changes, and remaining findings."

package/skills/hyv-apply-rebuild/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-apply-rebuild
+description: Validate and evaluate a whole-document rebuild response against a prepared authorized rebuild task.
+---
+
+# hyv-apply-rebuild
+
+Validate and evaluate a whole-document rebuild response against a prepared authorized rebuild task. Capability input requires host-guaranteed sensitive-input redaction. It never calls a provider.
+
+## Usage
+
+```text
+hyv apply-rebuild task.json response.json profile.json (--capability-stdin|--capability-file path)
+```
+
+## 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 apply-rebuild` directly to execute the operation. Follow-on agents: hyv-verify, hyv-lifecycle.

package/skills/hyv-apply-rebuild/agent.json

@@ -0,0 +1,49 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-apply-rebuild",
+  "title": "hyv-apply-rebuild",
+  "description": "Validate and evaluate a whole-document rebuild response against a prepared authorized rebuild task.",
+  "instruction_file": "SKILL.md",
+  "role": "Rebuild applier",
+  "workflow_phase": "edit",
+  "input": {
+    "required": [
+      "task.json",
+      "response.json",
+      "profile.json",
+      "capability stdin or file"
+    ],
+    "optional": []
+  },
+  "output": {
+    "required": [
+      "applied rebuild candidate and gate 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-verify",
+    "hyv-lifecycle"
+  ]
+}

package/skills/hyv-apply-rebuild/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Apply Rebuild"
+  short_description: "Validate and evaluate a whole-document rebuild response against a prepared authorized rebuild task."
+  default_prompt: "Use $hyv-apply-rebuild to validate and evaluate a whole-document rebuild response against a prepared authorized rebuild task."

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

@@ -0,0 +1,24 @@
+---
+name: hyv-apply-rewrite
+description: Validate and apply a model response to a prepared rewrite task, then run local gates.
+---
+
+# hyv-apply-rewrite
+
+Validate and apply a model response to a prepared task, then run the local gates. It never calls a provider or stores source or candidate text. Exits 2 unless the result is accepted.
+
+## Usage
+
+```text
+hyv apply-rewrite task.json response.json profile.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 apply-rewrite` directly to execute the operation. Follow-on agents: hyv-verify, hyv-prepare-judgment.

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

@@ -0,0 +1,48 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-apply-rewrite",
+  "title": "hyv-apply-rewrite",
+  "description": "Validate and apply a model response to a prepared rewrite task, then run local gates.",
+  "instruction_file": "SKILL.md",
+  "role": "Edit applier",
+  "workflow_phase": "edit",
+  "input": {
+    "required": [
+      "task.json",
+      "response.json",
+      "profile.json"
+    ],
+    "optional": []
+  },
+  "output": {
+    "required": [
+      "applied candidate and gate 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-verify",
+    "hyv-prepare-judgment"
+  ]
+}

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

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Apply Rewrite"
+  short_description: "Validate and apply a model response to a prepared rewrite task, then run local gates."
+  default_prompt: "Use $hyv-apply-rewrite to validate and apply a model response to a prepared rewrite task, then run local gates."

package/skills/hyv-batch-analyze/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-batch-analyze
+description: Inspect two to one hundred drafts for repeated opening and closing sentences.
+---
+
+# hyv-batch-analyze
+
+Inspect two to one hundred drafts for repeated opening and closing sentences. It returns advisory batch findings and does not store the drafts.
+
+## Usage
+
+```text
+hyv batch-analyze draft-a.md draft-b.md [draft-c.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 batch-analyze` directly to execute the operation. Follow-on agents: hyv-analyze.

package/skills/hyv-batch-analyze/agent.json

@@ -0,0 +1,45 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-batch-analyze",
+  "title": "hyv-batch-analyze",
+  "description": "Inspect two to one hundred drafts for repeated opening and closing sentences.",
+  "instruction_file": "SKILL.md",
+  "role": "Batch analyzer",
+  "workflow_phase": "analyze",
+  "input": {
+    "required": [
+      "two or more draft paths"
+    ],
+    "optional": []
+  },
+  "output": {
+    "required": [
+      "advisory batch findings"
+    ],
+    "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-analyze"
+  ]
+}

package/skills/hyv-batch-analyze/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Batch Analyze"
+  short_description: "Inspect two to one hundred drafts for repeated opening and closing sentences."
+  default_prompt: "Use $hyv-batch-analyze to inspect two to one hundred drafts for repeated opening and closing sentences."

package/skills/hyv-fact-lint/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-fact-lint
+description: Lint factual claims in a draft against named sources.
+---
+
+# hyv-fact-lint
+
+Lint factual claims in a draft against one or more named sources passed as --source=id:path. Optional --metadata provides fact metadata, --strict raises severity, and --human selects the human-readable report.
+
+## Usage
+
+```text
+hyv fact-lint <draft|-> --source=id:path [--source=id:path] [--metadata=metadata.json] [--strict] [--human]
+```
+
+## 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 fact-lint` directly to execute the operation. Follow-on agents: hyv-verify.

package/skills/hyv-fact-lint/agent.json

@@ -0,0 +1,50 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-fact-lint",
+  "title": "hyv-fact-lint",
+  "description": "Lint factual claims in a draft against named sources.",
+  "instruction_file": "SKILL.md",
+  "role": "Fact linter",
+  "workflow_phase": "verify",
+  "input": {
+    "required": [
+      "draft path",
+      "one or more --source=id:path"
+    ],
+    "optional": [
+      "--metadata=metadata.json",
+      "--strict",
+      "--human"
+    ]
+  },
+  "output": {
+    "required": [
+      "fact lint 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-verify"
+  ]
+}

package/skills/hyv-fact-lint/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Fact Lint"
+  short_description: "Lint factual claims in a draft against named sources."
+  default_prompt: "Use $hyv-fact-lint to lint factual claims in a draft against named sources."

package/skills/hyv-final-check/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-final-check
+description: Gate exact user-facing text from any model, tool, or interface.
+---
+
+# hyv-final-check
+
+Gate exact final text from every producer. Returns output only when clean or after removing a leading byte-order mark; unresolved hidden characters withhold output. It does not require or select a VoiceDNA profile. Run it immediately before display, copy, export, posting, or returning an API response.
+
+## Usage
+
+```text
+hyv final-check <path|->
+```
+
+## 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 final-check` directly to execute the operation.

package/skills/hyv-final-check/agent.json

@@ -0,0 +1,43 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-final-check",
+  "title": "hyv-final-check",
+  "description": "Gate exact user-facing text from any model, tool, or interface.",
+  "instruction_file": "SKILL.md",
+  "role": "Output gate",
+  "workflow_phase": "verify",
+  "input": {
+    "required": [
+      "text path or -"
+    ],
+    "optional": []
+  },
+  "output": {
+    "required": [
+      "accepted output or withheld 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": []
+}

package/skills/hyv-final-check/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Final Check"
+  short_description: "Gate exact user-facing text from any model, tool, or interface."
+  default_prompt: "Use $hyv-final-check to gate exact user-facing text from any model, tool, or interface."

package/skills/hyv-hygiene/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-hygiene
+description: Inspect text for zero-width characters, bidirectional controls, tag characters, and unusual spaces.
+---
+
+# hyv-hygiene
+
+Inspect text for zero-width characters, bidirectional controls, Unicode tag characters, and unusual spaces without requiring a voice profile. Inspection is read-only. --fix writes a new cleaned path (never overwriting the input or an existing output), reports every changed offset, and preserves controls it is not authorized to remove.
+
+## Usage
+
+```text
+hyv hygiene draft.md [--fix] [--output=cleaned.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 hygiene` directly to execute the operation. Follow-on agents: hyv-final-check.

package/skills/hyv-hygiene/agent.json

@@ -0,0 +1,50 @@
+{
+  "schema_version": "1.0.0",
+  "id": "hyv-hygiene",
+  "title": "hyv-hygiene",
+  "description": "Inspect text for zero-width characters, bidirectional controls, tag characters, and unusual spaces.",
+  "instruction_file": "SKILL.md",
+  "role": "Hygiene inspector",
+  "workflow_phase": "verify",
+  "input": {
+    "required": [
+      "draft path"
+    ],
+    "optional": [
+      "--fix",
+      "--output=cleaned.md"
+    ]
+  },
+  "output": {
+    "required": [
+      "hygiene report",
+      "optional cleaned file"
+    ],
+    "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-final-check"
+  ]
+}

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

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Hyv Hygiene"
+  short_description: "Inspect text for zero-width characters, bidirectional controls, tag characters, and unusual spaces."
+  default_prompt: "Use $hyv-hygiene to inspect text for zero-width characters, bidirectional controls, tag characters, and unusual spaces."

package/skills/hyv-inspect-hidden-text/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: hyv-inspect-hidden-text
+description: Inspect hidden text controls with a non-mutating policy report.
+---
+
+# hyv-inspect-hidden-text
+
+Inspect hidden text controls with a non-mutating policy report. Findings are not watermark verdicts. An optional policy.json restricts which controls are reported.
+
+## Usage
+
+```text
+hyv inspect-hidden-text draft.md [policy.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 inspect-hidden-text` directly to execute the operation. Follow-on agents: hyv-apply-hidden-text-policy, hyv-final-check.