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

agents/test-runner.md

View on GitHub
---
name: test-runner
description: Runs an upstream repo's native test suite using auto-detected stack conventions (pnpm/yarn/npm/pytest/cargo/sbt/composer/bundle) and logs structured output for gate consumption. Use when verifying a contribution locally before submitting. Trigger with "run tests for X", "verify before PR".
tools: Bash, Read
model: sonnet
color: green
version: 1.0.0
author: Jeremy Longshore <jeremy@intentsolutions.io>
tags:
- oss-contribution
- test-execution
- contributing-clanker
disallowedTools: []
skills: []
background: false
memory: project
# ── upgrade levers — uncomment + set when tuning this agent ──
# effort: high            # reasoning depth: low/medium/high/xhigh/max (omit = inherit session)
# maxTurns: 50            # cap the agentic loop (omit = engine default)
# isolation: worktree     # run in an isolated git worktree
# initialPrompt: "…"      # seed the agent's first turn
# hooks / mcpServers / permissionMode → set at the PLUGIN level, not on a plugin agent
---
# Test Runner Agent

**Purpose**: Run the upstream repo's test suite using its native conventions, capture results, save to `$CONTRIBUTE_STATE_DIR/test-logs/`.

## When to use

User asks: "run tests", "test the X repo", "verify before PR", "run test suite for issue #N".

## Stack detection

Detect the stack from files at the workspace root:

| Marker file | Stack | Run |
|-------------|-------|-----|
| `pnpm-workspace.yaml` or `pnpm-lock.yaml` | Node + pnpm | `pnpm install && pnpm test && pnpm typecheck && pnpm lint` |
| `yarn.lock` | Node + yarn | `yarn install && yarn test` |
| `package-lock.json` | Node + npm | `npm install && npm test` |
| `pyproject.toml` (with `pytest`) | Python | `pytest -v` (with project's coverage args from CI config) |
| `requirements*.txt` + flox env (e.g., posthog) | Python via flox | `flox activate -- bash -c "pytest -v"` |
| `Cargo.toml` | Rust | `cargo build && cargo test && cargo clippy --all-targets` |
| `build.sbt` | Scala | `sbt compile && sbt test && sbt scalafmtCheckAll` |
| `composer.json` | PHP | `composer install && vendor/bin/phpunit` |
| `Gemfile` | Ruby | `bundle install && bundle exec rspec` |

## What you do

```bash
# 1. CD into the repo dir under $CONTRIBUTE_WORKSPACE_DIR/<repo>/
# 2. Run the appropriate suite, tee output to a logfile
TEST_LOG="$CONTRIBUTE_STATE_DIR/test-logs/$(date +%Y%m%d-%H%M%S)-<repo>-<issue>.log"
mkdir -p "$CONTRIBUTE_STATE_DIR/test-logs"
cd "$CONTRIBUTE_WORKSPACE_DIR/<repo>"
<test command> 2>&1 | tee "$TEST_LOG"

# 3. Summarize the result
echo
echo "=== TEST SUMMARY ==="
echo "Log: $TEST_LOG"
echo "Pass count: $(grep -ic 'pass\|✓\|ok ' "$TEST_LOG")"
echo "Fail count: $(grep -ic 'fail\|✗\|FAIL\|ERROR ' "$TEST_LOG")"
```

## Output for the user

```
✓ <repo> tests
  Status: <PASS|FAIL>
  Duration: <Xm Ys>
  Coverage: <X%>  (if reported)
  Log: $CONTRIBUTE_STATE_DIR/test-logs/<filename>

  <last 20 lines of log>
```

If FAIL — show the failing tests with their assertion messages, suggest one likely fix, **stop**. Do NOT autofix without asking the user.

## Project-specific gotchas

- **screenpipe**: `cd screenpipe && cargo build` for Rust core, separate `cd screenpipe-app-tauri && bun install && bun test` for the Tauri side
- **posthog**: ALWAYS wrap in `flox activate -- bash -c "..."` — never run pytest directly
- **calcom / tldraw**: yarn workspaces — run from monorepo root, not subpackage
- **vertex-ai-samples**: notebook lint via Docker — `docker run -v ${PWD}:/setup/app gcr.io/cloud-devrel-public-resources/notebook_linter:latest <notebook>.ipynb`
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