skills.rest
asheshgoplani
asheshgoplaniCOMMUNITY
Explore all skills by this author →
𝕏@asheshgoplaniGitHub

agent-deck-contributor

Guides contributors through agent-deck's PR intake gate and four-lens review process.

827|144|Updated Dec 3, 2025
Search Tags:#contribution#Testing#ci#gitHub#GO#Code review#Pull request
One-click install
npx skills add https://github.com/asheshgoplani/agent-deck --skill agent-deck-contributor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-deck-contributor
Source: https://github.com/asheshgoplani/agent-deck/tree/main/.github/skills/agent-deck-contributor
Command: npx skills add https://github.com/asheshgoplani/agent-deck --skill agent-deck-contributor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Contributing to the agent-deck repository means passing a strict automated intake gate and a four-lens review machine (correctness, security, fit, intent); this Skill walks an agent or human through the exact contract so PRs pass intake on the first try instead of bouncing with needs-info labels.

Core Features & Use Cases

  • Full contribution loop: Covers claiming an issue, reproducing bugs, implementing scoped diffs, writing tests that fail without the fix, opening the PR, and responding to review verdicts.
  • Pre-open self-check script: Runs gofmt, go vet, sandboxed tests, a revert-check, diff-size and forbidden-path checks, a hidden-logic security sweep, and a PR-body lint against the intake contract.
  • Gate specification references: Maps every rule to the exact repo-side check with the precise fix, plus a passing PR-body template and an author-side security self-scan.
  • Use Case: An AI agent fixing an agent-deck issue captures the human's ask verbatim, writes a failing test first, runs scripts/self-check.sh on its drafted PR body, fixes every FAIL, and opens a PR that passes intake cleanly.

Quick Start

Ask the agent to fix an agent-deck issue and prepare a pull request that passes the repo's intake gate using this contributor skill.

Frequently Asked Questions about agent-deck-contributor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I open a PR that passes the agent-deck intake gate?▼

Use the PR template verbatim with all six required headings, check exactly one AI-disclosure box, quote the human's ask in the intent section, and end the body with the gate marker line. Run scripts/self-check.sh on your drafted body first and fix every FAIL before opening.

How do I run agent-deck tests safely before submitting a PR?▼

Run tests with the sandboxed invocation: HOME=$(mktemp -d) XDG_CONFIG_HOME= XDG_DATA_HOME= XDG_CACHE_HOME= go test ./... — never against a real home directory, since tests can destroy live user data. The self-check script runs this exact invocation automatically.

What is the revert-check in agent-deck PR review?▼

The reviewer reverts your non-test hunks and re-runs your tests; a test that still passes proves nothing. Write the test first, watch it fail, then implement the fix — self-check.sh automates this by running your changed tests against the merge-base in a temporary worktree.

Does agent-deck accept AI-authored pull requests?▼

Yes, disclosed AI PRs get equal standing: check exactly one disclosure box, name the model (or write 'unsure'), and be able to answer questions about the code. Undisclosed bulk-generated PRs get closed.

What are the pull request size limits for agent-deck?▼

Diffs over roughly 400 changed lines get flagged as oversized by the fit lens, and additions over 3000 lines require a linked issue or Discussion agreeing the shape first. You may also have at most 5 open PRs at a time.

Why did my agent-deck PR get a needs-info label?▼

The intake bot labels PRs missing required headings, an AI-disclosure box, or a non-empty intent section. Edit the PR description to fix the named field — the check re-runs automatically and no new commit is needed.

Related Skills

Explore More Software Engineering Skills→
m2ai-portfoliom2ai-portfolio
4

pretty-but-wrong

Enumerate unsourced claims, stale data, and calculation errors in AI-generated documents.

Official
Advanced
ondrasekondrasek
2

review-pr

Automate PR review loops by polling CI checks and threads.

Community
Advanced
tamago0224tamago0224

golang-security

Identify security vulnerabilities in Go code using govulncheck and static analysis.

Community
Advanced
Atrium-HermesAtrium-Hermes

Vuln Scanner

Identify real security vulnerabilities in trending repositories and route disclosures.

Community
Advanced