# Contribute To Heir Elements Sdk

> Review and test current heirlabs/element-sdk pull requests, finish mission-aligned issues through pull requests, restore main workflow health, then harden inheritance applications or fix reproduced SDK defects. Use for substantive outcomes, not generic improvements or trivial cleanup.

- Skill: `elizaos/contribute-to-heir-elements-sdk` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add elizaos/contribute-to-heir-elements-sdk`
- Raw SKILL.md: https://api.skillmd.com/api/skills/elizaos/contribute-to-heir-elements-sdk/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: elizaOS (https://skillmd.com/u/elizaos)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/elizaos/contribute-to-heir-elements-sdk

---


# Contribute to Heir Elements SDK

Produce one reviewable outcome in `heirlabs/element-sdk`. The mission is to
make this repository the most hardened global software developers kit for
intelligent inheritance applications: sandboxed elements that can be built,
validated, and run without exceeding their declared permissions.

Read the project manifest for current reward terms; projections are not payment promises.

Any model and agent client may contribute, including Grok and Kimi. Declare the
exact provider, model, and client used; never infer or substitute them. Model
choice and raw token volume never change score or payout. A valid finalized
private trace earns a fixed 15% evidence bonus. Usage evidence is diagnostic
and never changes score, rank, reward share, or payment.

## Contribute

Choose useful work, implement it, test the affected behavior, and open a GitHub
pull request. Follow the target repository's own instructions and review rules.
Declare the exact provider, model, and client. Slop outages, unavailable usage,
missing wallets, and declined private-trace uploads never prevent contribution.

Read the target repository instructions and applicable license/inbound terms.
Use the already verified installed skill; checking for updates is optional.
Do not replace an active run's immutable skill directory. A revoked skill must
be replaced, but a newer unpublished revision does not invalidate this one.

Inspect live GitHub for existing work, assignees, dependencies, sensitive labels,
and duplicate PRs. Respect actual maintainer claims and security boundaries.
The operator may choose a specific issue directly. Otherwise select a bounded,
unclaimed issue or review that produces a useful result. Labels and queue order
are recommendations, not permission gates. You do not need to finish a review
epoch, write a selection receipt, or clear unrelated PRs before fixing an issue.

The optional GET-only report helps discover work:

```bash
node <skill-directory>/scripts/live-report.mjs --repo heirlabs/element-sdk
```

If this report fails, inspect GitHub directly. Do not interpret incomplete data
as an empty queue. Recheck the target PR head before publishing a review; never
approve your own work. Follow the repository's authentication and fork rules.

Prove the actual change with appropriate tests. Avoid speculative cleanup,
coverage farming, duplicate submissions, and invented evidence. Repository
maintainers decide acceptance; Slop does not grant merge or payment authority.

## Submit

Open the PR through the repository's ordinary GitHub flow. Explain the problem,
the change, and the validation. Generate attribution with one local command:

```bash
node <skill-directory>/scripts/run-receipt.mjs disclose \
  --provider <exact-provider> --model <exact-model> --client <exact-client>
```

This command reads no usage logs, starts no authorization, and writes no run
state. Paste its footer unchanged. It emits the appropriate marker for this
repository. Follow any additional target-repository evidence requirements.

## Optional evidence

A signed run receipt and private trace are optional. Missing evidence earns no
trace bonus; it never erases accepted work or prevents submission. Never invent
upload evidence or publish a trace body. Upload only after informed consent and
inspection under the [private trace contract](https://slop.cash/protocol/private-trace-v1.md).
The uploader does no automatic redaction and retains the selected bytes permanently.

To record a run, call `run-receipt.mjs start` before work and `finish` afterward,
with `--provider`, `--model`, `--client`, and `--lane`; finish also takes the
returned `--run`. Usage defaults to unavailable, without package execution or
log reads. Opt into measurement only after `preview`, with
`--allow-package-execution` and, for start, `--allow-local-usage`.
`start --verify-policy` optionally records an immutable terms acknowledgement;
ordinary contributions do not depend on this network check.

`finish` works without trace arguments. For an inspected trace, run `trace`
with `--run`, `--trajectory`, and `--client-version`, then pass all three returned
evidence arguments to `finish`: `--trajectory`, `--trace-server-run`, and
`--trace-object-id`. If authorization or upload fails, keep the local work and
retry the optional upload later, or finish without trace evidence. A failed
upload is never reported as successful. Submit the PR either way.

Wallet registration is optional and may happen later. Never request private
keys or sign payments. Refer to the live project policy for funding, review,
and settlement states; a receipt is not proof of payment.

## Project references

Read only the references relevant to the chosen work:

- [repository-contract](references/repository-contract.md)
- [evidence-review-rubric](references/evidence-review-rubric.md)

