Sensible Contribution Flow

A useful contribution starts with understanding what would benefit a project, not just what could be changed.

This skill helps agents prepare discussions, issues, pull requests, and security reports with upstream fit in mind. Deciding not to contribute is also a valid outcome.

Select Workflow

Treat a request to investigate and prepare a change if warranted as pull request preparation, including documentation-only changes, unless the user explicitly requests assessment alone or edits without pull request preparation. Explicitly deferring the decision to contribute selects assessment-only, even when a future pull request is being considered. Uncertainty about whether the problem exists or postponing fork creation alone doesn’t make an otherwise authorized preparation request assessment-only.

Keep assessment-only requests and standalone reviews read-only. Follow contribution assessment, report the conclusions and material evidence limitations, then stop. A supplied checkout, linked pull request, or findings report doesn’t authorize preparation, fixes, or Git mutations.

For explicit local edits without pull request preparation, resolve scope and authority, follow Implement and Review for the scoped changes and applicable checks, then return directly to the working tree handoff. Honor existing user authorization without duplicate confirmation. This route doesn’t imply an automatic preparation grant, branch setup, commits, pull request draft, or remote mutation.

Load references only when the selected route or current phase requires them, and reuse established context and peer choices. For user-requested changes to an existing pull request, follow Revise Existing Pull Requests rather than restarting initial preparation.

For initial pull request preparation, use these default stages in execution order, resolving scope and authority before acting. Apply explicit task-scoped procedural and evidence check waivers under Agent Conduct. Do not advance past an unwaived prerequisite, required approval, or genuine human-only checkpoint: