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

scripts/gates/lib/preamble.sh

View on GitHub
#!/usr/bin/env bash
# Shared preamble for every gate script. Sourced as the first line of every
# gate. Eliminates the per-script bug surface that Slice 1's scout-discover.sh
# already showed (empty-array failures under set -u, jq parse errors on
# malformed gh output, etc.).
#
# Per-script gate authors: source this file FIRST, then implement the gate.
# Use the helpers below for output. NEVER `echo "{...}"` your verdict directly
# — use gate_pass / gate_warn / gate_block / gate_inform.

set -euo pipefail

: "${CONTRIBUTE_STATE_DIR:?CONTRIBUTE_STATE_DIR must be explicitly set}"
: "${CONTRIBUTE_WORKSPACE_DIR:?CONTRIBUTE_WORKSPACE_DIR must be explicitly set}"
export CONTRIBUTE_STATE_DIR CONTRIBUTE_WORKSPACE_DIR

# Global error trap — any uncaught error dumps a BLOCK verdict + exits 0.
# (Per gate contract: exit code is always 0; runner reads stdout JSON.)
_GATE_ID="${0##*/}"
_GATE_ID="${_GATE_ID%.sh}"

_gate_err_trap() {
  local exit_code=$?
  local line_no=$1
  /usr/bin/cat <<EOF
{"severity":"BLOCK","gate":"$_GATE_ID","reason":"gate $_GATE_ID crashed at line $line_no (exit $exit_code) — fail-closed","fix_hint":"check $CONTRIBUTE_STATE_DIR/check-runs/gate-debug.log; this is a bug in the gate itself"}
EOF
  exit 0
}
trap '_gate_err_trap $LINENO' ERR

# Emit a verdict and exit. Use these — never raw echo.
#
# Reason / fix_hint are JSON-escaped via jq long-form flags. Earlier versions used
# printf '%s' which dropped raw text into the JSON body and produced
# invalid output whenever any message contained a literal `"`. Caught by
# the e02-ai-strike-track unit tests on 2026-05-03.
gate_pass()   { jq --null-input --compact-output --arg g "$_GATE_ID" --arg r "${1:-ok}" '{severity:"PASS",gate:$g,reason:$r}'; exit 0; }
gate_warn()   { jq --null-input --compact-output --arg g "$_GATE_ID" --arg r "${1:-warning}" --arg f "${2:-}" '{severity:"WARN",gate:$g,reason:$r,fix_hint:$f}'; exit 0; }
gate_block()  { jq --null-input --compact-output --arg g "$_GATE_ID" --arg r "${1:-blocked}" --arg f "${2:-}" '{severity:"BLOCK",gate:$g,reason:$r,fix_hint:$f}'; exit 0; }
gate_inform() { jq --null-input --compact-output --arg g "$_GATE_ID" --arg r "${1:-noted}" '{severity:"INFORM",gate:$g,reason:$r}'; exit 0; }
gate_skip()   { jq --null-input --compact-output --arg g "$_GATE_ID" --arg r "${1:-not applicable}" '{severity:"SKIP",gate:$g,reason:$r}'; exit 0; }

# Read stdin JSON contract. Sets:
#   GATE_CANDIDATE_PATH — path to candidate .md file
#   GATE_DOSSIER_PATH — path to dossier .md (or empty if no dossier)
#   GATE_ACTION — transition name (e.g., "shortlist→claimed")
#   GATE_REPO — owner/repo
#   GATE_INPUT_JSON — raw stdin for any extra fields
gate_read_input() {
  GATE_INPUT_JSON=$(/usr/bin/cat)
  GATE_CANDIDATE_PATH=$(/usr/bin/printf '%s' "$GATE_INPUT_JSON" | jq -r '.candidate // ""')
  GATE_DOSSIER_PATH=$(/usr/bin/printf '%s' "$GATE_INPUT_JSON" | jq -r '.dossier // ""')
  GATE_ACTION=$(/usr/bin/printf '%s' "$GATE_INPUT_JSON" | jq -r '.action // ""')
  GATE_REPO=$(/usr/bin/printf '%s' "$GATE_INPUT_JSON" | jq -r '.env.repo // ""')
  export GATE_INPUT_JSON GATE_CANDIDATE_PATH GATE_DOSSIER_PATH GATE_ACTION GATE_REPO
}

# Read a frontmatter field from a markdown file. Returns empty if missing.
# Usage: val=$(fm_field /path/to/file.md "key")
fm_field() {
  local file="$1" key="$2"
  [[ -f "$file" ]] || { /usr/bin/printf ''; return; }
  /usr/bin/awk -v k="$key" '
    /^---$/ { fm = !fm ? 1 : 2; next }
    fm == 1 && $0 ~ "^"k":" {
      sub("^"k":[[:space:]]*", "")
      gsub(/^"|"$/, "")
      print
      exit
    }
  ' "$file"
}

# gh wrapper with bounded retry.
#
# Constraint: gate-runner enforces a 10s wall-clock timeout per gate. gh_safe
# must finish well under that to leave room for jq/awk downstream.
# Tuning: 2 attempts, 0.5s sleep between, 4s per-call timeout.
# Worst case ≈ 4 + 0.5 + 4 = 8.5s — leaves headroom.
#
# Permanent 404s (issue/repo doesn't exist) fail on the first call's HTTP error
# and don't usefully retry. Transient blips get one retry. That's enough for
# the read-only gh queries gates make.
#
# On final failure returns non-zero with empty stdout — caller decides what
# missing data means (usually `gate_pass`/`gate_inform`/`gate_skip`).
gh_safe() {
  local attempt=1 max=2
  while (( attempt <= max )); do
    if /usr/bin/timeout 4 gh "$@" 2>/dev/null; then return 0; fi
    /usr/bin/sleep 0.5
    attempt=$(( attempt + 1 ))
  done
  return 1
}

# Helper: log a gate run for observability. Append-only.
gate_log_run() {
  local verdict="$1"
  /usr/bin/printf '%s\n' "$(jq --null-input --compact-output \
    --arg ts "$(/usr/bin/date -u +%Y-%m-%dT%H:%M:%SZ)" \
    --arg gate "$_GATE_ID" \
    --arg action "$GATE_ACTION" \
    --arg repo "$GATE_REPO" \
    --arg verdict "$verdict" \
    '{ts: $ts, event: "gate_run", details: {gate: $gate, action: $action, repo: $repo, verdict: $verdict}}')" \
    >> "$CONTRIBUTE_STATE_DIR/log.jsonl" 2>/dev/null || true
}
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