OpenParable
Skip to content
← Back to skills

Harness Starter Coding

Development
harness-starter-coding

Harness Starter Coding is an Agent Skill for development published in the octos-org/octos repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Harnessed coding-assistant starter. Produces a unified-diff artifact and a file-list preview under patches/.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/octos-org/octos/blob/HEAD/crates/app-skills/harness-starter-coding/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/harness-starter-coding, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Harness Starter: Coding

A coding-assistant starter. Produces a unified-diff file as its primary deliverable plus a preview artifact listing the changed files. Copy this crate when you want to build an app that ships a patch/diff/changeset.

What this starter demonstrates

  • primary = "patches/*.diff" — the canonical deliverable.
  • preview = "patches/*.files.txt" — a secondary artifact the operator surface may use to summarize the change.
  • file_size_min:$primary:64 — validator rejects empty patches.
  • Multi-artifact spawn task binding (artifacts = ["primary", "preview"]) so the runtime delivers both files.

See docs/OCTOS_HARNESS_DEVELOPER_GUIDE.md for the full contract.

Tools

propose_patch

Render a patch as a unified-diff file plus a preview file list.

{
  "title": "Fix typo in hello",
  "hunks": [
    {
      "file": "src/lib.rs",
      "new_content": "pub fn hello() -> &'static str {\n    \"hi\"\n}\n"
    }
  ]
}

Parameters:

  • title (required): short title; derives the filename (patches/fix-typo-in-hello.diff).
  • hunks (required, non-empty): list of {file, new_content} hunks. Each hunk becomes a full-file replacement hunk in the diff.

Artifacts:

  • patches/<slug>.diff — primary unified-diff file.
  • patches/<slug>.files.txt — preview list of changed files.

Replace this stub

The starter generates full-file replacement hunks. A real coding assistant should use similar or diff to compute minimized unified diffs, and consider running the patch through git apply --check in a validator before delivery.