Repo config

Skill synaptiai/synapti-marketplace/plugins/gh-workflow/skills/repo-config

The Synapti Marketplace is a curated collection of Claude Code plugins designed for AI-augmented development + advanced analytical and research tasks. Each plugin provides specialized agents, skills, and commands that extend Claude Code's capabilities in specific domains.

Install

npx -y skills add synaptiai/synapti-marketplace --skill repo-config

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

6 stars6 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Provides dynamic repository configuration patterns for gh-workflow agents. Use when an agent needs the default branch name for diffs, the repository owner/name for API calls, or branch naming and commit conventions for validation.

SKILL.md

3.9 KB, 944 tokens by cl100k_base, as published. Nobody here has run it

Repository Configuration

Reference skill loaded into agent context via skills: repo-config. Provides patterns for dynamic repository detection so agents never hardcode branch names, repo identifiers, or conventions.

Core Commands

Default Branch

Used by code-reviewer for diff base and convention-checker for commit range:

DEFAULT_BRANCH=$(gh repo view --json defaultBranchRef --jq '.defaultBranchRef.name')

# Usage in agents:
git diff origin/$DEFAULT_BRANCH..HEAD           # code-reviewer
git log --oneline $DEFAULT_BRANCH..HEAD         # convention-checker

Repository Owner/Name

Used by implementation-planner for GitHub API calls:

REPO=$(gh repo view --json nameWithOwner --jq '.nameWithOwner')

# Usage in agents:
gh api repos/$REPO/issues/$ISSUE_NUMBER/comments
gh api repos/$REPO/pulls/$PR_NUMBER/comments

Combined Fetch

When multiple values are needed, minimize API calls:

gh repo view --json nameWithOwner,defaultBranchRef --jq '{
  repo: .nameWithOwner,
  default_branch: .defaultBranchRef.name
}'

Conventions

Used by convention-checker to validate branch names and commit messages. These defaults are configurable via settings.gh-workflow.json (see conventions.* keys in schema.json). Commands may also override with project-specific conventions from CLAUDE.md — check CLAUDE.md first, then settings, then these defaults.

Branch Naming

Configurable via .conventions.branchPatterns and .conventions.additionalBranchTypes in settings.

Type	Default Pattern	Example
Feature	`feature/issue-{N}-{desc}`	`feature/issue-42-add-login`
Fix	`fix/issue-{N}-{desc}`	`fix/issue-13-typo`
Docs	`docs/issue-{N}-{desc}`	`docs/issue-7-readme`

Additional branch types can be added via .conventions.additionalBranchTypes (e.g., {"refactor": "refactor/issue-{N}-{desc}", "chore": "chore/issue-{N}-{desc}"}).

Commit Prefixes

Configurable via .conventions.commitTypes in settings.

Prefix	Usage
`feat:`	New features
`fix:`	Bug fixes
`docs:`	Documentation
`refactor:`	Code refactoring
`test:`	Test changes
`chore:`	Maintenance

Detecting Project-Specific Conventions

# Check CLAUDE.md first (preferred source)
CLAUDE_MD=""
[ -f ".claude/CLAUDE.md" ] && CLAUDE_MD=".claude/CLAUDE.md"
[ -z "$CLAUDE_MD" ] && [ -f "CLAUDE.md" ] && CLAUDE_MD="CLAUDE.md"
[ -n "$CLAUDE_MD" ] && grep -A5 -E "(Branch|Commit|Convention)" "$CLAUDE_MD" 2>/dev/null

# Fall back to inferring from existing patterns
git for-each-ref --sort=-committerdate --format='%(refname:short)' refs/remotes/origin/ | head -10
git log --oneline -20

Agent Integration

This skill is loaded into agent context via skills: repo-config in agent frontmatter:

Agent	What it needs	Key commands
code-reviewer	`DEFAULT_BRANCH` for diff base	`git diff origin/$DEFAULT_BRANCH..HEAD`
convention-checker	`DEFAULT_BRANCH` for commit range, conventions for validation	`git log $DEFAULT_BRANCH..HEAD`, branch/commit patterns
implementation-planner	`REPO` for GitHub API calls	`gh api repos/$REPO/issues/...`
test-runner	Declared but not directly used	—

Error Handling

If gh commands fail:

Check	Command	Fix
Authentication	`gh auth status`	Run `gh auth login`
Git repository	`git rev-parse --git-dir`	Navigate to a git repo or run `git init`
GitHub remote	`git remote -v`	Add with `git remote add origin <url>`