SKILL.md

name: overlay-tools description: Gentoo overlay maintenance tools. Use /check-updates to find outdated packages, /update-ebuild to bump versions. license: MIT metadata: audience: maintainers workflow: gentoo-overlay aliases:

check-updates
update-ebuild

Overlay Tools

Maintenance tools for turbo-overlay Gentoo packages.

Commands

check-updates

Scan packages for available upstream updates.

# Check all packages
.opencode/skill/overlay-tools/bin/check-updates

# Check specific package
.opencode/skill/overlay-tools/bin/check-updates -p net-im/goofcord

# JSON output for scripting
.opencode/skill/overlay-tools/bin/check-updates --json

Options:

Flag	Description
`-p, --package CATEGORY/NAME`	Check specific package only
`--json`	Output JSON format
`-v, --verbose`	Show detailed progress
`--overlay-path PATH`	Path to overlay (default: current directory)

Exit Codes: 0 = updates available, 1 = errors, 2 = all up-to-date

update-ebuild

Bump ebuild versions with optional PR automation.

# Version bump
.opencode/skill/overlay-tools/bin/update-ebuild -y -v 1.2.3 media-video/hayase-bin

# With MY_PV mapping
.opencode/skill/overlay-tools/bin/update-ebuild -y -v 0.2025.12.10.08.12_p03 -m "0.2025.12.10.08.12.stable_03" x11-terms/warp-bin

# Dry run
.opencode/skill/overlay-tools/bin/update-ebuild -n -v 2.0.0 net-im/goofcord

# Create PR automatically (--pr implies -y)
.opencode/skill/overlay-tools/bin/update-ebuild --pr -v 3.68.0_pre -m "3.68.0" media-video/lossless-cut

Options:

Flag	Description
`-v, --version VERSION`	New version (required)
`-m, --my-pv MY_PV`	Set MY_PV for upstream version mapping
`-n, --dry-run`	Preview changes without applying
`-s, --skip-git`	Skip git operations
`-l, --lenient`	Allow non-standard version formats
`-k, --keep-old`	Keep old ebuild
`--skip-manifest`	Skip Manifest update (for CI)
`-y, --yes`	Auto-commit without prompting
`--pr`	Create PR after committing (implies -y)
`--base BRANCH`	Base branch for PR
`--branch BRANCH`	Override feature branch name
`--draft`	Create PR as draft
`--upstream-url URL`	Upstream release URL for PR body

Requirements

uv - Install: curl -LsSf https://astral.sh/uv/install.sh | sh

Environment Variables

Variable	Description
`GITHUB_TOKEN`	GitHub API token for higher rate limits

Workflow

Run check-updates to find outdated packages
Run update-ebuild --pr to bump version and create PR
Or manually: update-ebuild -v X.Y.Z category/package
Test: emerge -1v category/package
QA: pkgcheck scan category/package

Version Format Reference

Gentoo Format	Meaning
`1.2.3`	Standard release
`1.2.3_p1`	Patch release
`1.2.3_pre`	Pre-release
`1.2.3_alpha1`	Alpha
`1.2.3_beta2`	Beta
`1.2.3_rc1`	Release candidate

Score

Total Score

50/100

Based on repository quality metrics

✓SKILL.md

SKILL.mdファイルが含まれている

+20

○LICENSE

ライセンスが設定されている

0/10

○説明文

100文字以上の説明がある

0/10

○人気

GitHub Stars 100以上

0/15

○最近の活動

3ヶ月以内に更新がある

0/10

○フォーク

10回以上フォークされている

0/5

✓Issue管理

オープンIssueが50未満

+5

✓言語

プログラミング言語が設定されている

+5

○タグ

1つ以上のタグが設定されている

0/5

Reviews

💬

Reviews coming soon