Skip to content

Latest commit

 

History

History
102 lines (70 loc) · 3.98 KB

File metadata and controls

102 lines (70 loc) · 3.98 KB

greptile skills

Agent Skills for automated PR review workflows. Supports GitHub, GitLab, Perforce, and local Greptile CLI reviews. Requires git + gh CLI (GitHub), glab CLI (GitLab), p4 CLI (Perforce), or the Greptile CLI for local reviews.

Skills

Skill Description
check-pr Check a PR/MR/CL for unresolved comments, failing checks, incomplete description. Fix and resolve.
cli-review Run a Greptile CLI review from the current checkout and summarize findings.
greploop Loop: trigger Greptile review, fix comments, re-review — until 5/5 confidence and zero comments.

check-pr and greploop auto-detect the platform (GitHub, GitLab, or Perforce) from the environment. cli-review runs against the current local git checkout with the Greptile CLI.

Requirements

Platform CLI tool Install
GitHub gh cli.github.com
GitLab glab gitlab.com/gitlab-org/cli
Perforce p4 perforce.com/downloads
Greptile greptile greptile.com/cli

Authenticate before use: gh auth login, glab auth login, configure P4PORT/P4USER/P4CLIENT for Perforce, or greptile login.

Install

Claude Code

git clone https://github.com/greptileai/skills.git ~/.claude/skills/greptile
cd ~/.claude/skills
ln -s greptile/check-pr check-pr
ln -s greptile/cli-review cli-review
ln -s greptile/greploop greploop

Or as a submodule:

git submodule add https://github.com/greptileai/skills.git .skills/greptile
ln -s greptile/check-pr .skills/check-pr
ln -s greptile/cli-review .skills/cli-review
ln -s greptile/greploop .skills/greploop

Claude Code discovers skills by looking for SKILL.md files at ~/.claude/skills/<skill-name>/SKILL.md. Since this is a multi-skill repo, symlinks are needed to expose each sub-skill at the expected depth.

Pi / open-skills ecosystem

Agents that use the open skills CLI (the package manager for the Agent Skills spec linked above) — such as Pi — install directly from the repo, no cloning or symlinks needed:

# Install all three skills
npx skills add greptileai/skills

# Or install a single skill
npx skills add greptileai/skills/check-pr
npx skills add greptileai/skills/cli-review
npx skills add greptileai/skills/greploop

This resolves each <skill>/SKILL.md, copies it into your agent's skills directory, and records it in skills-lock.json. Update later with npx skills update.

Usage

Claude Code

Invoke by name (e.g. /check-pr 123, /cli-review, or /greploop).

Pi / intent-based agents

Pi loads a skill via progressive disclosure: it keeps every skill's description in context and reads the full SKILL.md on demand when a request matches that description. So activation is driven entirely by the description field — just describe what you want:

  • "check my PR for unresolved comments" → check-pr
  • "loop greptile review until it's 5/5" / "fix the greptile comments and re-review" → greploop
  • "run a greptile review before I open a PR" → cli-review

To force a specific skill explicitly, use Pi's skill command:

/skill:check-pr 123
/skill:greploop
/skill:cli-review

(The metadata.triggers entries in each skill's frontmatter are optional catalog hints for tooling that indexes skills; Pi ignores unknown metadata and does not use them for activation.)

Common options

If no PR/MR/CL number is given, check-pr and greploop auto-detect the PR/MR for the current branch, or the pending changelist for Perforce.

For self-hosted GitLab instances whose hostname doesn't contain "gitlab", pass --vcs gitlab explicitly. For Perforce, pass --vcs perforce if auto-detection fails.

License

MIT