dbpolito/skills

dbpolito のプロフィール

記録された最新のソース活動: 2026年10月4日 14:29

SkillsMP カタログ更新: 2026年10月17日 00:09

収集済み skills: 5

GitHub スター: 0
GitHub フォーク: 0

リポジトリの README

README の元ファイル：README.md

README の元ファイルを読む

README 全文を表示

# Skills Small, focused skills for coding agents. Install them with the [skills CLI](https://skills.sh/): ```sh npx skills add dbpolito/skills ``` Skill directory and manifest names follow the skill manifest convention: lowercase letters, numbers, and hyphens (for example, `get-pr-ready`), with the directory matching the manifest's `name`. Product documentation starts at [Overview](docs/index.md). Browse it locally with `(cd docs && npx @docmd/core dev)` from the repository root. | Skill | Purpose | | --- | --- | | [review-pr](#review-pr) | Investigate a PR and publish evidence-backed review findings. | | [get-pr-ready](#get-pr-ready) | Fix CI failures and work through review feedback. | | [create-pr](#create-pr) | Create a PR with a concise title and body from the final branch changes. | | [worktree](#worktree) | Create a worktree and move the current OpenCode session into it. | | [rift](#rift) | Archived; use [worktree](#worktree) instead. | | [rmslop](#rmslop) | Remove AI-generated code slop from uncommitted changes or a branch diff. | | [doc-driven](#doc-driven) | Specify product behavior in linked docs, then implement approved changes. | ## doc-driven Maintain concise page, feature, and shared-rule docs with a review boundary between specification and implementation. It can establish a baseline from an existing product, separating observed behavior from intended requirements and uncertainty. ```sh npx skills add dbpolito/skills --skill doc-driven ``` On a project without product docs, invoke `@doc-driven`. It inspects the project, chooses a fitting structure, creates an initial documentation baseline with a docmd viewer, and stops for review. No bootstrap prompt is needed. - **Specify:** ask “use doc-driven specify to describe …”. The agent reads related docs and consumers, edits only documentation, and stops for review. - **Implement:** after approval, ask “use doc-driven implement for the approved …”. The agent updates implementation and tests, reports discrepancies, and reconciles verified behavior without silently changing requirements. Edit product docs directly to describe the desired behavior, then review the documentation diff before implementation. Shared rules have one owner with links from consumers; known implementation gaps remain visible. No separate specs, proposal sections, or status labels are needed. Initialization creates `docs/docmd.config.json` with visible navigation, Search/Mermaid enabled, and the AI Assistant disabled. Viewer output, runtime dependencies, and their ignore rules stay inside `docs/`. Browse with `(cd docs && npx @docmd/core dev)` from the repository root. Source: [`skills/doc-driven/SKILL.md`](skills/doc-driven/SKILL.md). ## review-pr Review an existing pull request independently, then reconcile previous feedback and publish one formal GitHub review. It traces changed behavior through callers, state, and dependencies, checks potential defects against counterevidence, and reports concrete failures with concise inline comments. It keeps tracked files and pinned revisions unchanged and reads test code without running it by default. Tests and setup commands require an explicit user request; requested test runs stay safe, targeted, and within scope. Reviews include a star grade, coverage summary, and revision details with the full model reference, including any variant (or `unknown` when unavailable). Material gaps produce **Review incomplete**, never an approval. Existing unresolved findings and explicitly deferred risks remain visible across reruns. ### Install and run ```sh npx skills add dbpolito/skills --skill review-pr -g -a opencode npx opencode-ci@latest run --auto --skill review-pr 'Review and publish findings for PR #123 in owner/repo' ``` Requires `git`, authenticated `gh`, `jq`, the PR head checked out, and enough Git history to find its merge base. The publishing account needs permission to submit PR reviews. ### Run in CI Copy these examples into `.github/workflows/`. Both OAuth and API-key authentication are supported. Adjust the commented sections, model, and secrets to your setup. See [opencode-ci](https://github.com/dbpolito/opencode-ci) for credential setup. Reviews run for non-draft, same-repository PRs. The example includes an optional owner/member restriction as a comment. New commits cancel the previous review for that PR. Keep the checkout's explicit `ref`: GitHub otherwise checks out a synthetic merge commit, which fails the skill's pinned-head check. Set repository variable `OPENCODE_MODEL` and, for OAuth, repository secrets `OPENCODE_CI_AUTH_JSON` and `PAT_TOKEN`. The PAT needs **Secrets: Read and write** for this repository. Enable **Allow GitHub Actions to create and approve pull requests** in repository Actions settings if the bot should approve clean reviews. The review and keepalive workflows can overlap, and queued workflows retain their original repository secrets. Concurrent OAuth refreshes can invalidate or overwrite saved tokens; authentication failures may require reseeding the auth secret. A green workflow means the agent process completed, not necessarily that it published a review. Check its formal review or **Review automation failure** comment for the outcome. #### PR review [View file](examples/opencode-review-pr.yml) · [Raw / download](https://raw.githubusercontent.com/dbpolito/skills/main/examples/opencode-review-pr.yml) ```yaml name: opencode-review-pr on: pull_request: types: [opened, synchronize, reopened, ready_for_review] permissions: contents: read pull-requests: write jobs: review: # To restrict authors, append: && contains(fromJSON('["OWNER", "MEMBER"]'), github.event.pull_request.author_association) if: github.event.pull_request.draft == false && github.event.pull_request.head.repo.full_name == github.repository runs-on: ubuntu-latest timeout-minutes: 55 concurrency: group: opencode-review-pr-${{ github.event.pull_request.number }} cancel-in-progress: true env: GH_TOKEN: ${{ github.token }} PR_NUMBER: ${{ github.event.pull_request.number }} BASE_SHA: ${{ github.event.pull_request.base.sha }} HEAD_SHA: ${{ github.event.pull_request.head.sha }} REVIEW_LOGIN: github-actions[bot] REVIEW_MODEL: ${{ vars.OPENCODE_MODEL }} REVIEW_AGENT: build steps: - uses: actions/checkout@v4 with: # The skill reviews the PR head, not GitHub's synthetic merge commit. ref: ${{ github.event.pull_request.head.sha }} fetch-depth: 0 persist-credentials: false - uses: actions/setup-node@v4 with: node-version: '24' - name: Install review skill run: npx --yes skills add dbpolito/skills --skill review-pr -g -a opencode -y # Auth: keep this step and the save step below. # API key: remove both auth steps. - name: Load auth credentials id: auth env: OPENCODE_CI_AUTH_JSON: ${{ secrets.OPENCODE_CI_AUTH_JSON }} run: printf '%s' "$OPENCODE_CI_AUTH_JSON" > "$HOME/opencode-ci.auth.json" - name: Review # API key: uncomment these lines (or use your provider's variable). # env: # OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }} run: | npx --yes opencode-ci@latest run --auto --thinking \ --agent "$REVIEW_AGENT" --model "$REVIEW_MODEL" --timeout 2700 \ --title "review-pr $GITHUB_RUN_ID/$GITHUB_RUN_ATTEMPT" \ --skill review-pr \ 'Review and publish findings for the PR supplied in the environment.' # Auth only: persist refreshed credentials even after a failed review. - name: Save refreshed auth credentials if: always() && steps.auth.outcome == 'success' env: GH_TOKEN: ${{ secrets.PAT_TOKEN }} OPENCODE_CI_AUTH_JSON: ${{ secrets.OPENCODE_CI_AUTH_JSON }} run: | if ! cmp -s "$HOME/opencode-ci.auth.json" <(printf '%s' "$OPENCODE_CI_AUTH_JSON"); then gh secret set OPENCODE_CI_AUTH_JSON --repo "$GITHUB_REPOSITORY" < "$HOME/opencode-ci.auth.json" fi ``` #### Auth keepalive [View file](examples/opencode-auth.yml) · [Raw / download](https://raw.githubusercontent.com/dbpolito/skills/main/examples/opencode-auth.yml) ```yaml name: opencode-auth on: schedule: - cron: '0 9 * * *' # Daily at 09:00 UTC. workflow_dispatch: permissions: contents: read concurrency: group: opencode-auth cancel-in-progress: false jobs: refresh: runs-on: ubuntu-latest timeout-minutes: 10 steps: - uses: actions/setup-node@v4 with: node-version: '24' - name: Load auth credentials id: auth env: OPENCODE_CI_AUTH_JSON: ${{ secrets.OPENCODE_CI_AUTH_JSON }} run: printf '%s' "$OPENCODE_CI_AUTH_JSON" > "$HOME/opencode-ci.auth.json" - name: Refresh auth env: OPENCODE_MODEL: ${{ vars.OPENCODE_MODEL }} run: | npx --yes opencode-ci@latest run --model "$OPENCODE_MODEL" --timeout 120 \ 'Reply only OK. Do not use tools.' - name: Save refreshed auth credentials if: always() && steps.auth.outcome == 'success' env: GH_TOKEN: ${{ secrets.PAT_TOKEN }} OPENCODE_CI_AUTH_JSON: ${{ secrets.OPENCODE_CI_AUTH_JSON }} run: | if ! cmp -s "$HOME/opencode-ci.auth.json" <(printf '%s' "$OPENCODE_CI_AUTH_JSON"); then gh secret set OPENCODE_CI_AUTH_JSON --repo "$GITHUB_REPOSITORY" < "$HOME/opencode-ci.auth.json" fi ``` Source: [`skills/review-pr/SKILL.md`](skills/review-pr/SKILL.md). ## get-pr-ready Keep working on an existing pull request until its branch includes the latest base, required CI checks pass, required reviews are approved, and no actionable feedback remains. The skill uses `gh` to inspect CI and review feedback, including inline threads. It fetches and merges the latest base when the PR branch is behind, even without conflicts. It verifies feedback, fixes CI failures and valid review issues, tests, commits, and pushes, then replies in the addressed inline threads with commit links and validation results. It rechecks the latest base/head, addresses available issues before waiting for checks, and reports blockers requiring human input or an external fix. It leaves thread resolution to reviewers unless requested, and never approves its own PR, dismisses reviews, or merges the PR. ### Install ```sh npx skills add dbpolito/skills --skill get-pr-ready ``` To install it globally for OpenCode: ```sh npx skills add dbpolito/skills --skill get-pr-ready -g -a opencode ``` ### Use Ask your agent to **“get this PR ready”** and provide a PR number or URL. If you don't provide one, the skill uses the current branch's PR. You'll need `gh` installed and authenticated for the relevant repository. Source: [`skills/get-pr-ready/SKILL.md`](skills/get-pr-ready/SKILL.md). ## create-pr Create a PR from the current branch's committed changes. Follow the repository's PR template when present, focus on the final outcome, and use before/after evidence for visual changes or benchmarks when available. A writing-only request does not push or publish anything. ### Install ```sh npx skills add dbpolito/skills --skill create-pr ``` Ask your agent to **“create a PR”** and optionally provide the target base branch. Source: [`skills/create-pr/SKILL.md`](skills/create-pr/SKILL.md). ## worktree Create a worktree, move the current OpenCode session into it, and continue the original task. OpenCode uses the project's configured worktree strategy, including Rift when configured. ### Install ```sh npx skills add dbpolito/skills --skill worktree ``` To install it globally for OpenCode: ```sh npx skills add dbpolito/skills --skill worktree -g -a opencode ``` ### Use Ask your agent to **“work in a new worktree.”** Requires OpenCode's built-in `opencode.worktree_create` and `opencode.session_move` tools. Source: [`skills/worktree/SKILL.md`](skills/worktree/SKILL.md). ## rift Archived. Use the [worktree skill](#worktree) instead. The original Rift-specific instructions remain in [`skills/rift/SKILL.md`](skills/rift/SKILL.md). ## rmslop Remove unnecessary comments, defensive checks, `any` casts, emoji, and other code that doesn't fit the surrounding style from uncommitted changes or a branch diff. Inspired by [OpenCode's `/rmslop` command](https://github.com/anomalyco/opencode/blob/dev/.opencode/command/rmslop.md). ### Install ```sh npx skills add dbpolito/skills --skill rmslop ``` Ask your agent to **“rmslop”** to clean up uncommitted changes, or **“rmslop this branch”** for branch changes. Source: [`skills/rmslop/SKILL.md`](skills/rmslop/SKILL.md).

リポジトリの README を読み込んでいます…

投稿

すべて見る →

Daniel Polito

@dbpolito2026年9月28日 17:05 UTC

活用例引用投稿コードと PR をレビュー

投稿の要約 · 英語

Shows review-pr running in CI on the author's own repository, with a linked example workflow.

引用元の投稿に含まれるメディア

元の投稿

Skill の詳細を見る · skills/skills-review-pr

このリポジトリの skills

分類待ち

skill

職業分類

説明

更新

review-pr

未分類

Review GitHub pull requests in CI for bugs and regressions, reconcile existing feedback, and publish actionable inline findings.

原文の言語: 英語

2026-10-04

rmslop

未分類

Remove AI code slop

原文の言語: 英語

2026-10-03

get-pr-ready

未分類

Fix CI failures and address review feedback on an existing PR. Use when asked to get a PR ready for merge.

原文の言語: 英語

2026-09-30

create-pr

未分類

Create a pull request with a concise title and body. Use when asked to open a PR for the current branch.

原文の言語: 英語

2026-09-28

rift

未分類

Create and switch to an isolated Rift-backed worktree. Use when asked to work in a new worktree, Rift workspace, or isolated checkout.

原文の言語: 英語

2026-09-28

収集済み skill 5 件中 5 件を表示しています。

AI アシスタントでインストール

このプロンプトをコピーして、使用中の AI アシスタントに送ってください。

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/dbpolito/skills.