Skip to content
OpenSmartRoute
Skillv1.0.0

contribute-publish

Publish one prepared OSS contribution action to GitHub after a fresh human approval boundary. Shows the exact target, content, command, commit, and test evidence before any mutation. Use when local pr

by jeremylongshore(0) 0 installs
Free
Sign in to install

Free account. Installing gives you the manifest plus copy-paste snippets.

See reviews

About

Imported from jeremylongshore/tons-of-skills-marketplace (skills/.curated/contribute-publish/SKILL.md). Install upstream with npx skills add jeremylongshore/tons-of-skills-marketplace --skill contribute-publish. Copyright stays with the author (MIT).

Contribute Publish

Overview

Perform exactly one approved GitHub mutation from a completed local preparation packet. This skill has no authority to discover unrelated work, create persistent state, install dependencies, or expand the approved scope.

Prerequisites

  • A completed contribute-prepare review packet with final content, target, commit SHA, changed files, and passing evidence.
  • GitHub CLI authenticated through the user's existing credential store.
  • A clean understanding of the upstream's contribution, disclosure, CLA/DCO, branch, and review policies.

Mandatory approval boundary

Before any external action, show all of the following:

  1. GitHub repository and issue or pull-request target.
  2. Exact action and command category (issue comment, issue create, pr create, pr comment, or git push).
  3. Complete content that will be posted, or the exact branch/ref that will be pushed.
  4. Exact prepared commit SHA and changed-file list when code is involved.
  5. Test and lint evidence.
  6. Any warnings, overrides, AI-use disclosure, CLA, or DCO requirement.

Then ask for explicit approval for that exact action. Approval must appear in the current conversation after the review packet. Earlier blanket permission, installation, authentication, repository ownership, or approval of a different target does not count.

Instructions

  1. Use Read only to inspect the final prepared packet and approved body file.
  2. Present the mandatory approval boundary below.
  3. Wait for fresh approval for the exact action.
  4. Execute once, read back the resulting GitHub object, and stop.
  • Execute only the approved action and target.
  • Use the user's existing gh authentication; never request, read, or print a token.
  • Do not merge, force-push, approve reviews, bypass repository rules, close an issue, or delete a branch unless that exact operation received its own review packet and explicit approval.
  • If content or the target changes after approval, present the revised packet and ask again.
  • After execution, read back the resulting GitHub object and report its URL and authoritative state.
  • On failure, report the error and stop. Do not broaden permissions or retry with a more powerful command.

Supported actions

gh issue comment "$ISSUE_NUMBER" --repo "$REPOSITORY" --body-file "$APPROVED_FILE"
gh issue create --repo "$REPOSITORY" --title "$APPROVED_TITLE" --body-file "$APPROVED_FILE"
git -C "$APPROVED_WORKTREE" push "$APPROVED_REMOTE" "$APPROVED_REFSPEC"
gh pr create --repo "$REPOSITORY" --head "$APPROVED_HEAD" --base "$APPROVED_BASE" \
  --title "$APPROVED_TITLE" --body-file "$APPROVED_FILE"

These are examples, not permission to run them. Never combine multiple mutations under one approval unless the review packet explicitly lists each one.

Examples

  • publish this approved claim comment — show the final comment and target, obtain fresh approval, post once, then read back the issue comment URL.
  • open the prepared pull request — verify the prepared SHA and checks, show the exact base/head/title/body, obtain fresh approval, create once, and read back the pull request state.
  • push this prepared branch — show the exact worktree, remote, commit, and refspec; approval applies only to that push.

Output

Return the action performed, repository and target, resulting URL, resulting state read back from GitHub, and any remaining local-only follow-up.

Error handling

Condition Response
No fresh explicit approval Stop without mutation
Packet lacks tests, SHA, target, or final content Return to contribute-prepare
GitHub rejects the action Report the error; do not bypass controls
Target/content changed Invalidate approval and present a new packet

Resources

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml
targets:
  - https://api.opensmartroute.ai/api/v1/registry/jeremylongshore-tons-of-skills-marketplace-contribute-publish/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

jeremylongshore-tons-of-skills-marketplace-contribute-publish.ocm.jsonjson
{
  "ocm": "1",
  "id": "jeremylongshore-tons-of-skills-marketplace-contribute-publish",
  "kind": "skill",
  "name": "contribute-publish",
  "description": "Publish one prepared OSS contribution action to GitHub after a fresh human approval boundary. Shows the exact target, content, command, commit, and test evidence before any mutation. Use when local preparation is complete and the user explicitly asks to post a claim, create a Design Issue, comment, push a branch, or open a pull request. Trigger with \"/contribute-publish\" or \"publish this prepared contribution\".",
  "publisher": "jeremylongshore",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "oss",
      "contributions",
      "github",
      "publishing",
      "human-approval",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Publish one prepared OSS contribution action to GitHub after a fresh human approval boundary. Shows the exact target, content, command, commit, and test evidence before any mutation. Use when local preparation is complete and the user explicitly asks to post a claim, create a Design Issue, comment, push a branch, or open a pull request. Trigger with \"/contribute-publish\" or \"publish this prepared contribution\"."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/jeremylongshore/tons-of-skills-marketplace",
      "path": "skills/.curated/contribute-publish/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/HEAD/skills/.curated/contribute-publish/SKILL.md",
      "key": "jeremylongshore/tons-of-skills-marketplace/skills/.curated/contribute-publish/SKILL.md"
    },
    "compatibility": "Model-agnostic; requires git and an authenticated GitHub CLI with permission for the approved action",
    "allowed_tools": [
      "Read",
      "Bash(gh:*)",
      "Bash(git:*)"
    ],
    "license": "MIT"
  },
  "instructions": "# Contribute Publish\n\n## Overview\n\nPerform exactly one approved GitHub mutation from a completed local preparation\npacket. This skill has no authority to discover unrelated work, create persistent\nstate, install dependencies, or expand the approved scope.\n\n## Prerequisites\n\n- A completed `contribute-prepare` review packet with final content, target,\n  commit SHA, changed files, and passing evidence.\n- GitHub CLI authenticated through the user's existing credential store.\n- A clean understanding of the upstream's contribution, disclosure, CLA/DCO,\n  branch, and review policies.\n\n## Mandatory ap",
  "cost": {
    "context_tokens": 990
  }
}

Fetch it by URL: GET /api/v1/registry/jeremylongshore-tons-of-skills-marketplace-contribute-publish/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.