Skip to content

jeremylongshore/tons-of-skills-marketplace / plugins/community/contributing-clanker/skills/contribute-prepare

contribute-prepare

Verified

Prepare an OSS contribution locally after a read-only contribution audit. Creates explicitly scoped candidate records, repository dossiers, worktrees, test evidence, and gate results, but never publishes to GitHub. Use when the user has selected an issue and asks to set up, research, implement, test, or draft the contribution. Trigger with "/contribute-prepare" or "prepare this contribution locally".

FileKindSize
SKILL.mdskill md5.1 KB
agents/draft-writer.mdmarkdown2.0 KB
agents/repo-analyzer.mdmarkdown3.1 KB
agents/researcher.mdmarkdown10.5 KB
agents/scout.mdmarkdown7.5 KB
agents/test-runner.mdmarkdown3.5 KB
assets/claim-template.mdmarkdown714 B
assets/evidence-template.mdmarkdown532 B
assets/pr-template.mdmarkdown890 B
references/candidate-file-format.mdmarkdown9.3 KB
references/workflow-guide.mdmarkdown3.9 KB
scripts/audit-overrides.shexecutablescript7.3 KB
scripts/catalog-coverage.shexecutablescript4.0 KB
scripts/check.shexecutablescript1.1 KB
scripts/gate-runner.shexecutablescript8.9 KB
scripts/gates/a01-already-assigned.shexecutablescript1.1 KB
scripts/gates/a02-already-shipped.shexecutablescript1.3 KB
scripts/gates/a03-duplicate-flagged.shexecutablescript851 B
scripts/gates/a04-issue-age.shexecutablescript3.8 KB
scripts/gates/a05-issue-still-open.shexecutablescript1.6 KB
scripts/gates/a06-claim-etiquette-required.shexecutablescript1.6 KB
scripts/gates/a09-mention-routing.shexecutablescript2.1 KB
scripts/gates/b01-base-branch.shexecutablescript969 B
scripts/gates/b02-branch-naming.shexecutablescript1.0 KB
scripts/gates/b03-clone-fresh.shexecutablescript1.0 KB
scripts/gates/b05-dco-signoff.shexecutablescript1.5 KB
scripts/gates/b06-commit-format.shexecutablescript1.4 KB
scripts/gates/b07-scope-files.shexecutablescript2.1 KB
scripts/gates/b12-new-deps.shexecutablescript1.7 KB
scripts/gates/b14-local-checks.shexecutablescript1.7 KB
scripts/gates/b16-local-check-allowlist.shexecutablescript1.8 KB
scripts/gates/c01-draft-first.shexecutablescript902 B
scripts/gates/c02-pr-title-format.shexecutablescript1.2 KB
scripts/gates/c03-pr-body-sections.shexecutablescript2.0 KB
scripts/gates/c04-ui-screenshots.shexecutablescript1.6 KB
scripts/gates/c05-test-evidence.shexecutablescript1.4 KB
scripts/gates/c07-coauthor-banned.shexecutablescript1.2 KB
scripts/gates/c09-issue-link.shexecutablescript1.5 KB
scripts/gates/c11-no-force-push.shexecutablescript1.3 KB
scripts/gates/c12-ci-green.shexecutablescript1.2 KB
scripts/gates/c13-bots-passed.shexecutablescript2.1 KB
scripts/gates/c16-no-self-merge.shexecutablescript914 B
scripts/gates/c19-body-claim-vs-diff.shexecutablescript2.9 KB
scripts/gates/d02-no-ai-bug-reports.shexecutablescript1.4 KB
scripts/gates/d03-no-ai-pr-reviews.shexecutablescript1.1 KB
scripts/gates/d05-no-reopen.shexecutablescript1.1 KB
scripts/gates/e02-ai-strike-track.shexecutablescript2.7 KB
scripts/gates/e04-fork-target.shexecutablescript1.5 KB
scripts/gates/f01-license-compat.shexecutablescript3.5 KB
scripts/gates/f03-fixtures-clean.shexecutablescript1.2 KB
scripts/gates/f04-override-disclosure.shexecutablescript2.4 KB
scripts/gates/g01-no-vendored-edits.shexecutablescript1.9 KB
scripts/gates/g02-protected-paths.shexecutablescript1.2 KB
scripts/gates/g03-no-changelog-edits.shexecutablescript1.4 KB
scripts/gates/g04-no-version-bump.shexecutablescript1.4 KB
scripts/gates/g06-override-rate-limit.shexecutablescript1.5 KB
scripts/gates/lib/preamble.shexecutablescript4.8 KB
scripts/lint-candidate.shexecutablescript5.1 KB
scripts/researcher-build.shexecutablescript17.6 KB
scripts/researcher-refresh.pyscript4.9 KB
scripts/setup.shexecutablescript1.7 KB
scripts/test-known-traps.shexecutablescript5.4 KB
scripts/test-override-audit.shexecutablescript3.5 KB
scripts/test-plug-in.shexecutablescript4.0 KB
scripts/test-scout-refresh.shexecutablescript4.9 KB
scripts/test-stale-dossier-refresh.shexecutablescript3.7 KB
scripts/transition.shexecutablescript10.3 KB

references/workflow-guide.md

View on GitHub
# Portable preparation workflow

## Contents

1. [Authority phases](#authority-phases)
2. [Explicit setup](#explicit-setup)
3. [Prepare one contribution](#prepare-one-contribution)
4. [Host adapters](#host-adapters)
5. [Failure handling](#failure-handling)

## Authority phases

The plugin separates work into three independently invoked skills:

1. `contribute` performs read-only GitHub and repository-policy audits.
2. `contribute-prepare` writes local state and worktree files only inside paths
   the user explicitly selected.
3. `contribute-publish` performs one reviewed GitHub mutation after fresh human
   approval.

Never collapse these phases for convenience. Authentication proves identity; it
does not grant permission to publish.

## Explicit setup

The user selects two absolute, profile-scoped paths:

```bash
export CONTRIBUTE_STATE_DIR=/profile/path/contributing-clanker
export CONTRIBUTE_WORKSPACE_DIR=/profile/path/contribution-worktrees

bash <contribute-prepare-skill-dir>/scripts/setup.sh \
  --state-dir "$CONTRIBUTE_STATE_DIR" \
  --workspace-dir "$CONTRIBUTE_WORKSPACE_DIR"
```

Nothing runs this command automatically. The state directory holds markdown
candidates, dossiers, logs, checks, and test evidence. The workspace directory
holds only the upstream repositories the user selected for contribution work.

## Prepare one contribution

### 1. Confirm the audit

Require a `ready-to-prepare` result or repeat the read-only checks. Confirm the
issue is open, not assigned, not already solved, and compatible with repository
policy.

### 2. Create the candidate record

Create one file below `$CONTRIBUTE_STATE_DIR/candidates/` using
[candidate-file-format.md](candidate-file-format.md). Record the live issue URL,
repository, issue number, status, bounded scope, expected files, and dossier
path. Do not store credentials or environment snapshots.

### 3. Build the dossier

Use `scripts/researcher-build.sh <owner>/<repo>` or equivalent read-only GitHub
requests. Capture contribution rules, AI policy, CLA/DCO, base branch, branch and
commit conventions, required checks, templates, and maintainer preferences.

### 4. Establish the worktree

Clone or select the repository below `$CONTRIBUTE_WORKSPACE_DIR`. Read its
repository-scoped instruction files. Those files control work in that repository
only; they do not override the active host's safety, approval, or credential
rules.

### 5. Implement and validate

Implement only the agreed scope. Run the repository's documented dependency,
build, test, lint, and formatting commands. Dependency installation is permitted
only inside the selected worktree. Save logs below
`$CONTRIBUTE_STATE_DIR/test-logs/`.

### 6. Run deterministic gates

Use the bundled transition engine in dry-run mode:

```bash
bash <contribute-prepare-skill-dir>/scripts/transition.sh \
  working→submitted \
  "$CONTRIBUTE_STATE_DIR/candidates/<candidate>.md" \
  --dry-run
```

Resolve BLOCK results. Disclose any justified override in the final packet.

### 7. Produce a review packet

Provide the target, exact commit SHA, changed files, diff summary, tests, policy
evidence, gate results, and complete draft. State that no external action was
taken. Publication requires a separate `contribute-publish` invocation.

## Host adapters

The files under `agents/` describe optional roles such as scouting, dossier
research, drafting, and test execution. Hosts without those agent concepts may
perform the same work inline. Do not require a Claude-specific path, command,
memory bank, or approval identity.

## Failure handling

| Failure | Response |
|---|---|
| Paths unset or unsafe | Stop before writing |
| GitHub read fails | Preserve local work and report missing evidence |
| Repository instructions conflict | Follow the stricter applicable rule and request clarification |
| Tests or gates fail | Keep the work local and report exact failures |
| User requests publication | Produce the review packet and route to `contribute-publish` |
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 196kUpdated Claude CodeCodexVerifiedInstall