Skip to main content
affpapa.org
RU EN
skill Claude Code CX Codex Cursor GitHub Copilot

pr-workflow — Claude Code skill: what it does, how to install

Enforces rules for atomic commits, clean PRs, dependency licensing, and secret hygiene. Useful for agents pushing code or running inside CI workflows.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add tursodatabase/turso --skill pr-workflow -a claude-code
Open on GitHub

What pr-workflow does

This skill defines standards for code contributions. It instructs the agent to create atomic commits, separating logic changes from formatting or refactoring. Commits must never include .env files, credentials, or secrets. Before opening a PR, the agent runs relevant tests and keeps changes small.

When adding third-party dependencies, the agent must save the license file into licenses/ and update NOTICE.md. It forbids guessing API parameters or CLI arguments, requiring the model to inspect official documentation first. If your repository lacks a licenses/ directory or NOTICE.md, these strict requirements will require manual adjustments.

For CI runs configured via .github/workflows/claude.yml, the skill accounts for GitHub Actions turn limits. Agents are permitted to commit WIP states and open draft PRs so they stay focused without getting stuck in loops.

What it helps with

  • keep commit histories atomic without mixing logic and formatting
  • prevent committing credentials, secrets, and .env files
  • track third-party licenses in licenses/ and NOTICE.md
  • avoid GitHub Actions max-turn timeouts by pushing WIP commits

Example prompts for the agent

  • Prepare a pull request with atomic commits and run the test suite before submitting.
  • Add this dependency, place its license in licenses/ and update NOTICE.md.
  • Check git status to ensure no .env files or secrets are staged.

How to install pr-workflow

1Skills CLI (Vercel)

npx skills add tursodatabase/turso --skill pr-workflow -a claude-code

2Manually: put the files in place

~/.claude/skills/pr-workflow/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/pr-workflow/

From the same set10

The whole set →
code-quality tursodatabase Correctness rules, Rust patterns, and anti-over-engineering guidance for coding agents working in your repo. Claude Code CX Codex Cursor +1 1,800installs storage-format tursodatabase A reference for the SQLite file format: header, pages, B-trees, cells, overflow, freelist, tied to Turso's storage code. Claude Code CX Codex Cursor +1 1,300installs testing tursodatabase Skill teaches you to write tests for SQL and Rust: choose between .sqltest, TCL and integration formats, run test suites with the right commands. Claude Code CX Codex Cursor +1 1,300installs async-io-model tursodatabase Teaches the agent Turso's cooperative async I/O patterns: explicit state machines, IOResult, and avoiding re-entrancy bugs. Claude Code CX Codex Cursor +1 1,300installs debugging tursodatabase A skill for tracking down tursodb bugs: compare bytecode against SQLite, turn on trace logs, run ThreadSanitizer, replay a seed and measure stack use. Claude Code CX Codex Cursor +1 1,300installs index-knowledge tursodatabase Skill automatically creates hierarchical AGENTS.md documentation for a codebase. Analyzes project structure, scores directory complexity, and generates files with instructions for AI agents. Claude Code CX Codex Cursor +1 1,300installs mvcc tursodatabase Architectural reference for experimental MVCC in Turso: row versioning, snapshot isolation, and known memory limits. Useful when working on database internals. Claude Code CX Codex Cursor +1 1,200installs differential-fuzzer tursodatabase This skill guides Turso differential fuzzer runs and investigates differences against SQLite. Use it when generated SQL may expose correctness bugs. Claude Code CX Codex Cursor +1 1,200installs

Similar

simplify-code Hermes Agent (inspired by Claude Code /simplify) Reviews recent code changes through four parallel subagents and applies justified cleanup fixes. Use it after edits to simplify code that already works. Claude Code CX Codex Cursor +1 345installs debugging-wizard https://github.com/Jeffallan Investigates errors, stack traces, and logs to locate failure points. Use it for crashes, exceptions, regressions, or code that behaves unexpectedly. Claude Code CX Codex Cursor +1 5,100installs wt-switch-create max-sixty Creates a worktrunk worktree and switches the active session into it, optionally in another repository. Useful when isolating tasks or starting a session in a clean branch. Claude Code CX Codex Cursor +1 1,400installs github-project-management ruvnet Turns issue triage and board upkeep into gh and ruv-swarm calls: labels, subtasks, duplicate lookup. Useful when the tracker holds more tickets than order. Claude Code CX Codex Cursor +1 1,400installs scrutinize thananon An outsider-perspective review skill for plans, pull requests, and diffs. It challenges intent first, traces execution paths beyond the diff, and flags structural flaws. Claude Code CX Codex Cursor +1 5,200installs threat-model-analyst official github Runs STRIDE-A threat modeling for a repository or system. It can also update an earlier report against the current code or a chosen commit. GitHub Copilot 1,500installs triage Matt Pocock This skill moves issues and external PRs through triage states, verification, and agent briefs. It fits maintainers managing an issue queue. Claude Code 990,453installs code-review Matt Pocock Reviews changes from a chosen reference point against repository standards and the originating spec. Use it for a branch, PR, or work in progress. Claude Code 789,521installs

Questions about pr-workflow

How do I install pr-workflow in Claude Code?

Run npx skills add tursodatabase/turso --skill pr-workflow -a claude-code. Alternatively, place the skill file directly at ~/.claude/skills/pr-workflow/SKILL.md.

What does the pr-workflow skill do?

It provides guidelines for clean git commits, pull request hygiene, and dependency tracking. It also prevents secret leaks and stops the agent from guessing CLI arguments.

How does pr-workflow handle GitHub Actions limits?

The skill acknowledges the max-turns limit in .github/workflows/claude.yml. It allows the agent to commit WIP code and open draft PRs to avoid hitting action execution limits.

Source text

SKILL.md · MIT 
---
name: pr-workflow
description: General guidelines for Commits, formatting, CI, dependencies, security
---
# PR Workflow Guide

## Commit Practices

- **Atomic commits.** Small, focused, single purpose
- **Don't mix:** logic + formatting, logic + refactoring
- **Good message** = easy to write short description of intent

Learn `git rebase -i` for clean history.

## PR Guidelines

- Keep PRs focused and small
- Run relevant tests before submitting
- Each commit tells part of the story

## CI Environment Notes

If running as GitHub Action:
- Max-turns limit in `.github/workflows/claude.yml`
- OK to commit WIP state and push
- OK to open WIP PR and continue in another action
- Don't spiral into rabbit holes. Stay focused on key task

## Security

Never commit:
- `.env` files
- Credentials
- Secrets

## Third-Party Dependencies

When adding:
1. Add license file under `licenses/`
2. Update `NOTICE.md` with dependency info

## External APIs/Tools

- Never guess API params or CLI args
- Search official docs first
- Ask for clarification if ambiguous

© tursodatabase · MIT · tursodatabase/turso

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor