propel-code-review

Propel Code Skills

Official docs: Skills

This repo ships these skills:

• propel-code-review: Run async diff-based code reviews with the Propel Review API.
• carl: Run a continuous review/fix loop until Propel comments are cleared.
• propel-address-pr-comments: Fetch and address Propel AI comments on the open PR for the current branch.

Prerequisite

Set PROPEL_API_KEY in your environment before running these skills. Generate a Review API token from Review API Tokens.

export PROPEL_API_KEY="rev_..."

To make it persistent, add the export to your shell profile:

# bash
echo 'export PROPEL_API_KEY="rev_..."' >> ~/.bashrc && source ~/.bashrc

# zsh
echo 'export PROPEL_API_KEY="rev_..."' >> ~/.zshrc && source ~/.zshrc

Install

Codex

Install from GitHub (installs all three skills: propel-code-review, carl, and propel-address-pr-comments):

$skill-installer propel-gtm/propel-code-skills

For local plugin testing, this repo now also includes Codex plugin manifests at plugins/propel-code-review/.codex-plugin/plugin.json and .agents/plugins/marketplace.json.

Claude Code

Run these commands in Claude Code to install all three skills (propel-code-review, carl, and propel-address-pr-comments):

/plugin marketplace add propel-gtm/propel-code-skills
/plugin install propel-code-review@propel-code-skills

Cursor

Project-scoped install (recommended):

mkdir -p .cursor/skills
cp -R plugins/propel-code-review/skills/propel-code-review .cursor/skills/
cp -R plugins/propel-code-review/skills/carl .cursor/skills/
cp -R plugins/propel-code-review/skills/propel-address-pr-comments .cursor/skills/

User-scoped install:

mkdir -p ~/.cursor/skills
cp -R /path/to/propel-code-skills/plugins/propel-code-review/skills/propel-code-review ~/.cursor/skills/
cp -R /path/to/propel-code-skills/plugins/propel-code-review/skills/carl ~/.cursor/skills/
cp -R /path/to/propel-code-skills/plugins/propel-code-review/skills/propel-address-pr-comments ~/.cursor/skills/

Usage Prompts

Use `propel-code-review` to review the diff from base branch to HEAD, then report findings before final output.

Use `carl` to repeatedly run `propel-code-review` and address valid comments until none remain.

Use `carl` and publish a sticky GitHub PR summary comment only when the loop reaches a terminal stop condition (COMPLETE, BLOCKED, or MAX_ITERATIONS_REACHED), with counts of fixed/deferred/remaining comments.

Use `propel-address-pr-comments` to find the open PR for the current branch, fetch Propel findings, ask which comments to address, and apply fixes for selected findings.

CARL PR Summary Comment

CARL can publish/update a sticky summary comment on the open PR using Propel Review API, but this should run once at terminal stop condition only. If no PR exists yet, the script persists a pending terminal CARL run (POST /v1/reviews/carl-runs) for later PR bridging. This keeps the comment author as Propel Bot (instead of local gh user identity).

python plugins/propel-code-review/skills/carl/scripts/post_carl_summary_comment.py \
  --status COMPLETE \
  --base main \
  --iterations 3 \
  --fixed 7 \
  --deferred 1 \
  --remaining 0 \
  --checks passed \
  --review-ids "019c...,019d..." \
  --notes "Local CARL loop finished."

Optional:

export PROPEL_API_BASE_URL="https://api.propelcode.ai"

Dry run (no GitHub write):

python plugins/propel-code-review/skills/carl/scripts/post_carl_summary_comment.py \
  --status COMPLETE \
  --iterations 1 \
  --fixed 1 \
  --deferred 0 \
  --remaining 0 \
  --checks passed \
  --dry-run

Permission Smoke Test

From a target repository (for example, propel-gtm), run:

/path/to/propel-code-skills/plugins/propel-code-review/skills/propel-code-review/scripts/smoke_test_permissions.sh

This checks:

• good token + good repo (202)
• good token + bad repo (404)
• bad token + good repo (401/403)