# Ki Trade

> Operate one repository's side of a declared cross-repository trade: prepare, inspect, submit, receive, release, or prune a work or knowledge record. Use for one concrete trade action; `ki-trades` owns record and route governance, while `ki-work next` owns receiver disposition.

- Skill: `knowledgeislands/ki-trade-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx get-skill add knowledgeislands/ki-trade-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/knowledgeislands/ki-trade-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: knowledgeislands (https://skillmd.com/u/knowledgeislands)
- Updated: 2026-11-16
- Page: https://skillmd.com/skills/knowledgeislands/ki-trade-2

---


# ki-trade

**Kind:** process.

Operates the selected repository's local side of a trade without writing a peer checkout or deciding the receiver's response.

Read [the trade-operations procedure](references/standards-trade-operations.md) before running a mutating operation.

## Lifecycle

```text
preparing (mutable and committed)
  ├─ abandon → removed before submission
  └─ submit → submitted (immutable, awaiting receipt)
                 └─ receive → received / unconsidered
                                  └─ ki-work next records the receiver decision

sender observation policy: unattended | receipt | decision | completion
```

Preparation, delivery, receiver decision, and sender observation are separate facts. A committed preparation is silently observable; it is not receivable and creates no acknowledgement or receiver copy. Submission freezes the record. Receipt proves only that the receiver created its local immutable copy.

## What this skill does

- **Prepare, observe, submit, or abandon** one sender-owned preparation.
- **Receive** one explicitly identified submitted record, or preview and confirm an explicit `--all` batch.
- **List and show** local records and observable peer state without changing either repository.
- **Release or prune** only copies whose governed eligibility is currently observable.
- **Inspect routes** with `routes list|check` and `standing list|check`; routes and standing grants are read from the Capital trade policy and are never edited locally. In a Capital, `ki repo trade policy show|check|compare` presents, sweeps, and compares the territory trade policy. A route change is a proposal to the Capital, which preserves every route that still has a dependent record.

`ki-trades` owns the record, route, authority, and lifecycle contract. The operator must audit before and after a mutation, but this guidance does not claim that the current host makes those audits part of one transaction. Do not infer atomic file publication, preview/write equivalence, or post-write validation from this skill; those are host capabilities and require direct host evidence.

## Responsibility boundary

`ki-trade` never sets a receiver disposition. It hands a validated inbound record to `ki-work next`, which records the exact human-confirmed decision and chooses between a direct local application and a separately confirmed roadmap proposal.

It never creates or prioritises roadmap work, retains knowledge, claims local completion, writes another repository, transmits an observation, or keeps a dialogue or revision log. Git history is the only preparation history.

## Invocation

`help` / `-h` / `?` explains this skill and stops, taking no action.

The remaining invocations map one-to-one to the local `ki trade` surface. Before any mutation, resolve the physical repository root, run the `ki-trades` audit, inspect the host's exact local write or deletion preview, and obtain any confirmation required by [the procedure](references/standards-trade-operations.md). Re-audit afterward. Do not add an all-or-nothing interpretation to the asynchronous `receive --all` convenience operation, or treat this guidance as proof of any separate host capability.

With no recognised operation, show the lifecycle, observation policies, available operations, and the `ki-work next` disposition off-ramp, then stop.

## Notes

- This is a process skill, not a universal AUDIT / CONFORM / EDUCATE / REFRESH checker.
- `unattended` means no response is requested; it still retains the submitted copy until receipt is observable.
- `unattended` is an itemised observation policy, not a standing intake, automatic transport, execution, acceptance, or publication grant.
- `completion` observes the receiver's linked local work; it does not create a generic trade-completed state.
- Installed as a core user skill by `ki bootstrap`; it is not a repository-governance root.

