Harness Setup
$harness-setup is the explicit setup capability behind the Claude
/dhpk:setup front door. It owns setup and configuration evidence; it does not
silently broaden a host's authority or invent a second installer.
When to Use
- The operator explicitly requests
$harness-setup or /dhpk:setup.
- The operator wants to inspect effective setup with
--show.
- The operator explicitly selects a host-supported asset installation group.
When NOT to Use
- Harness scoring, budget analysis, trimming, or cross-platform synchronization:
these retired optional tools are outside the setup contract.
- Application code, ordinary configuration edits, or credentials not covered by
the host setup procedure.
- A request that supplies a new
--host selector. Host is detected from the
current runtime; do not add a public host flag.
Host and resource resolution
- Detect the current Host from the native invocation context and available
tools. A Claude command context selects the Claude adapter; a Codex
project-local skill context selects the Codex adapter. If the context is
ambiguous, stop
BLOCKED with HOST_UNRESOLVED rather than guessing.
- Load exactly one package-local adapter reference: Claude setup
or Codex setup. A missing reference or declared
runtime asset is
BLOCKED_RESOURCE_MISSING; do not scan ambient checkouts or
remote URLs for a replacement.
- Preserve the caller's argument string. The accepted grammar is the
argument-hint above; unknown options are BLOCKED. --source-artifact
is explicit task input for asset or Codex installation; it is never inferred
from a checkout, plugin cache, parent directory, or sibling Skill.
The adapter references, executable wrappers, and procedure resources are
Skill-local. scripts/install-assets.sh and
scripts/install-codex-project.sh resolve their physical helpers from their
own BASH_SOURCE; they execute no adapter selected from the source artifact.
The source artifact supplies bytes and manifests only. A missing local helper
is BLOCKED_RESOURCE_MISSING; a missing or invalid explicit artifact is
SOURCE_ARTIFACT_REQUIRED or SOURCE_ARTIFACT_INVALID.
Workflow
- Resolve the consumer project root and read current host state before any
write. Existing settings, user files, receipt entries, and unrelated dirty
work remain intact.
- If
--install is present, run the local asset adapter with the explicit
source artifact before configuration questions, then report its result and
stop. Default --install rules writes .claude/rules/dhpk-overrides.md
and does not vendor .claude/dhpk/rules/; pass --vendor only for the
discouraged verbatim copy. Do not combine asset installation with
interactive reconfiguration.
- If
--show is present, display effective current state and stop without
questions or writes. Otherwise follow the selected adapter's configuration
flow, using its native prompt mechanism when available and a visible
confirmation boundary before writes.
- Verify the resulting state from the host's authoritative settings or
receipt. Keep
PASS, BLOCKED, UNAVAILABLE, NOT_CONFIGURED, and
NOT_RUN distinct; a planned or skipped operation is not a pass.
Output
Return one report with:
Host → operation/arguments → planned/applied/preserved/unsupported items
Evidence → PASS | BLOCKED | UNAVAILABLE | NOT_CONFIGURED | NOT_RUN
Next action → exactly one host-appropriate follow-up
For a write-capable run, include the target root, changed paths, preserved
conflicts, receipt or settings evidence, and the command/exit result. Redact
keys, tokens, and credentials. Never claim that an installation happened when
only a plan or structural receipt was observed.
In the report, remind adopters who use skill handoff saves to add .scratch/ to
their .gitignore; do not edit that file.
Verification
References
- references/claude-setup.md — Claude settings,
userConfig, and asset behavior.
- references/codex-setup.md — Codex project
installer, receipt ownership, and Claude-only option boundaries.
1---2name: harness-setup3argument-hint: '[--show] [--source-artifact=<dir>] [--install=<group>] [--dry-run] [--force] [--vendor]'4description: 'Configure or inspect the dhpk harness, or install selected host assets. Not for: ordinary harness audits, application changes, or silent credential/configuration changes. Output: a host-specific setup report with preserved-file, receipt, and terminal evidence.'5disable-model-invocation: true6metadata:7 source: https://skillmd.com/skills/hmj1026/harness-setup8 dhpk-capability-id: dhpk.skill.harness-setup9 dhpk-name-style: portable-skill10 dhpk-invocation-class: explicit-only11---1213# Harness Setup1415`$harness-setup` is the explicit setup capability behind the Claude16`/dhpk:setup` front door. It owns setup and configuration evidence; it does not17silently broaden a host's authority or invent a second installer.1819## When to Use2021- The operator explicitly requests `$harness-setup` or `/dhpk:setup`.22- The operator wants to inspect effective setup with `--show`.23- The operator explicitly selects a host-supported asset installation group.2425## When NOT to Use2627- Harness scoring, budget analysis, trimming, or cross-platform synchronization:28 these retired optional tools are outside the setup contract.29- Application code, ordinary configuration edits, or credentials not covered by30 the host setup procedure.31- A request that supplies a new `--host` selector. Host is detected from the32 current runtime; do not add a public host flag.3334## Host and resource resolution35361. Detect the current Host from the native invocation context and available37 tools. A Claude command context selects the Claude adapter; a Codex38 project-local skill context selects the Codex adapter. If the context is39 ambiguous, stop `BLOCKED` with `HOST_UNRESOLVED` rather than guessing.402. Load exactly one package-local adapter reference: [Claude setup](references/claude-setup.md)41 or [Codex setup](references/codex-setup.md). A missing reference or declared42 runtime asset is `BLOCKED_RESOURCE_MISSING`; do not scan ambient checkouts or43 remote URLs for a replacement.443. Preserve the caller's argument string. The accepted grammar is the45 `argument-hint` above; unknown options are `BLOCKED`. `--source-artifact`46 is explicit task input for asset or Codex installation; it is never inferred47 from a checkout, plugin cache, parent directory, or sibling Skill.4849The adapter references, executable wrappers, and procedure resources are50Skill-local. `scripts/install-assets.sh` and51`scripts/install-codex-project.sh` resolve their physical helpers from their52own `BASH_SOURCE`; they execute no adapter selected from the source artifact.53The source artifact supplies bytes and manifests only. A missing local helper54is `BLOCKED_RESOURCE_MISSING`; a missing or invalid explicit artifact is55`SOURCE_ARTIFACT_REQUIRED` or `SOURCE_ARTIFACT_INVALID`.5657## Workflow58591. Resolve the consumer project root and read current host state before any60 write. Existing settings, user files, receipt entries, and unrelated dirty61 work remain intact.622. If `--install` is present, run the local asset adapter with the explicit63 source artifact before configuration questions, then report its result and64 stop. Default `--install rules` writes `.claude/rules/dhpk-overrides.md`65 and does not vendor `.claude/dhpk/rules/`; pass `--vendor` only for the66 discouraged verbatim copy. Do not combine asset installation with67 interactive reconfiguration.683. If `--show` is present, display effective current state and stop without69 questions or writes. Otherwise follow the selected adapter's configuration70 flow, using its native prompt mechanism when available and a visible71 confirmation boundary before writes.724. Verify the resulting state from the host's authoritative settings or73 receipt. Keep `PASS`, `BLOCKED`, `UNAVAILABLE`, `NOT_CONFIGURED`, and74 `NOT_RUN` distinct; a planned or skipped operation is not a pass.7576## Output7778Return one report with:7980```text81Host → operation/arguments → planned/applied/preserved/unsupported items82Evidence → PASS | BLOCKED | UNAVAILABLE | NOT_CONFIGURED | NOT_RUN83Next action → exactly one host-appropriate follow-up84```8586For a write-capable run, include the target root, changed paths, preserved87conflicts, receipt or settings evidence, and the command/exit result. Redact88keys, tokens, and credentials. Never claim that an installation happened when89only a plan or structural receipt was observed.9091In the report, remind adopters who use skill handoff saves to add `.scratch/` to92their `.gitignore`; do not edit that file.9394## Verification9596- [ ] Host was detected without a new public host flag.97- [ ] Only the selected Skill-local adapter and its declared resources were98 loaded; artifact files were treated as data.99- [ ] Existing user files and unrelated receipt entries were preserved.100- [ ] `--install`, `--show`, and unsupported-option boundaries101 match the selected Host.102- [ ] The terminal evidence state and one next action are explicit.103104## References105106- [references/claude-setup.md](references/claude-setup.md) — Claude settings,107 `userConfig`, and asset behavior.108- [references/codex-setup.md](references/codex-setup.md) — Codex project109 installer, receipt ownership, and Claude-only option boundaries.