Freenet PR Creation Guidelines

What it does

This skill provides a comprehensive checklist and procedural guidance for authors creating pull requests against Freenet repositories. It codifies pre-PR steps (claiming issues, syncing with main, creating worktrees), required local checks (formatting, linting, tests), appropriate test levels (simulation vs docker vs manual), and standards for PR titles, descriptions, and regression tests. It also covers review process expectations and CI/responsibility workflows.

When to use it

Use this skill whenever you are preparing a PR for freenet-core, freenet-stdlib, or related Freenet repositories. It's especially useful for feature work, bug fixes that require tests, and any change that touches routing/topology or other critical systems where simulation tests are needed. Apply before opening the PR and during review iterations.

What's included

• Scripts: none embedded, but the skill references standard CLI commands (gh, cargo) and simulation runners.
• References: detailed guidelines on test levels, CI expectations, and review agent workflow.
• Instructions: a clear procedural checklist: claim issue, sync main, create a worktree, run formatting/linting/tests, choose test level, write Conventional Commits-style title, include rationale and tests in PR description, and follow the prescribed review/respond flow.

Compatible agents

This is a repository-focused procedural skill and is compatible with code-review and PR automation agents (GH CLI-based agents, code-review assistants like Codex/Claude).