Agent skill

Promoter Publish

by mohitagw15856 in mohitagw15856/pm-claude-skills

Register a finished skill in this library and produce the complete release package: the bundle wiring and marketplace entry, the regenerated catalogue and exports, the headline count in every living…

MITAuto-check passedDevelopment

Install Promoter Publish

skills CLI
$ npx skills add mohitagw15856/pm-claude-skills --skill promoter-publish -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mohitagw15856/pm-claude-skills promoter-publish --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/promoter-publish .claude/skills/promoter-publish && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
promoter-publish
GitHub stars
1.4k
Token cost
~1.2k tokens
SKILL.md length
596 words
Files
2 (incl. scripts)
Skills in repo
1,348
Repo updated
First seen
Licence
MIT

At a glance

Register a finished skill in this library and produce the complete release package: the bundle wiring and marketplace entry, the regenerated catalogue and exports, the headline count in every living…

  • Works in 7 steps: Wire: node scripts/new-bundle.mjs --name… → Generate: catalogue, exports, workflows,… → Count: the new live-skill count goes… → …
  • Asked to publish this skill
  • SKILL.md covers What This Skill Produces, Required Inputs, Framework: The Package, in Order and Programmatic Helper, plus 4 more sections
  • Runs Python scripts from its folder; calls python3 and node

What it does

Promoter Publish is an agent skill from mohitagw15856/pm-claude-skills. Register a finished skill in this library and produce the complete release package: the bundle wiring and marketplace entry, the regenerated catalogue and exports, the headline count in every living document, the CHANGELOG entry, the gates to run, and the exact git and release commands. Use when asked to publish this skill, release the new skill, add it to the marketplace, ship the promoted skill, or as the last step of the promote loop. Produces the full release package, never a partial one, with a confirmation…

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/promoter_publish.py`).

It sits in Development, covering Changelog and release notes. It works with Git. The repository describes itself as: 1255 professional Agent Skills for Claude, ChatGPT, Gemini, Cursor & Codex — PRDs, postmortems, leases, medical bills, layoffs, go-bags, new countries. Plain markdown, MIT, in… The licence is MIT.

When your agent uses it

  • Asked to publish this skill
  • Release the new skill
  • Add it to the marketplace
  • Ship the promoted skill

Example prompts

  • “/promoter-publish”

Requirements

  • Python 3

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Wire: node scripts/new-bundle.mjs --name --desc "..." --skills ; it copies the skill into the bundle and adds the marketplace entry.
  2. Generate: catalogue, exports, workflows, samples, SKILLS.md, disambiguation, conformance badge, risk tiers. Outputs are committed; they…
  3. Count: the new live-skill count goes into package.json and server.json descriptions and every living document the drift check lists…
  4. Gate: skillcheck, duplicate check, vendor neutrality, eval coverage, drift. All green or stop.
  5. Version: package.json, server.json (two places), .claude-plugin/marketplace.json, python/pyproject.toml.
  6. CHANGELOG: new heading, Added and Changed lists, the count line.
  7. Commit, tag, push, release: the release triggers npm, PyPI, the MCP registry and the newsletter automatically. A deleted tag can never be…

What it can do on your machine

Read from SKILL.md and the folder at commit 1cbf1f0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Promoter Publish loads about 1.2k tokens when it runs. Until then it costs about 142 tokens; SKILL.md has 596 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~142
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from mohitagw15856/pm-claude-skills at commit 1cbf1f0, republished under its MIT licence (© mohitagw15856). 596 words, ~1,204 tokens.

Download SKILL.mdSave it as .claude/skills/promoter-publish/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
promoter-publish
description
Register a finished skill in this library and produce the complete release package: the bundle wiring and marketplace entry, the regenerated catalogue and exports, the headline count in every living document, the CHANGELOG entry, the gates to run, and the exact git and release commands. Use when asked to publish this skill, release the new skill, add it to the marketplace, ship the promoted skill, or as the last step of the promote loop. Produces the full release package, never a partial one, with a confirmation step before anything is pushed.
version
1.0.0

Promoter Publish

Publishing a skill here is more than copying a file: the bundle manifest, the marketplace entry, the catalogue, twelve platform exports and the headline count in a dozen documents all have to agree, and CI fails on the first one that does not. This skill produces the whole package in the order the repository expects, runs the gates, and hands the user the release commands with a confirmation before anything leaves the machine.

Last step of the promote loop. Follows promoter-test.

What This Skill Produces

  • Wiring: the bundle's plugin.json and the .claude-plugin/marketplace.json entry (generated by scripts/new-bundle.mjs, never hand-edited)
  • Regenerated artefacts: web/skills.json, SKILLS.md, DISAMBIGUATION.md, the exports, the conformance badge, the risk tiers
  • The headline count updated in every living document the drift check reads
  • A CHANGELOG entry under a new version heading in Keep-a-Changelog form
  • The release commands: commit, tag, push, GitHub release, with the version bumped in every manifest
  • A release note ready to paste

Required Inputs

Ask for these if not provided:

  • The skill name and the bundle it joins (new or existing)
  • The version: a new skill wave bumps the major; a fix bumps the patch
  • Confirmation before the push and the release; everything up to that point is local and reversible

Framework: The Package, in Order

  1. Wire: node scripts/new-bundle.mjs --name <bundle> --desc "..." --skills <skill>; it copies the skill into the bundle and adds the marketplace entry.
  2. Generate: catalogue, exports, workflows, samples, SKILLS.md, disambiguation, conformance badge, risk tiers. Outputs are committed; they are never edited by hand.
  3. Count: the new live-skill count goes into package.json and server.json descriptions and every living document the drift check lists. Deprecated skills stay on disk but are not counted.
  4. Gate: skillcheck, duplicate check, vendor neutrality, eval coverage, drift. All green or stop.
  5. Version: package.json, server.json (two places), .claude-plugin/marketplace.json, python/pyproject.toml.
  6. CHANGELOG: new heading, Added and Changed lists, the count line.
  7. Commit, tag, push, release: the release triggers npm, PyPI, the MCP registry and the newsletter automatically. A deleted tag can never be reused; fix forward with a patch bump.
Show full SKILL.md (251 more words)Show less

Programmatic Helper

bash
python3 skills/promoter-publish/scripts/promoter_publish.py <skill> --bundle <bundle> --version 80.0.0

It checks the skill has the required sections and no em dashes, then prints the package above with the exact commands. It runs nothing; the user runs each block after reading it.

Output Format

Release package: <skill> in <bundle>, v<version>
  1. Files added and changed (list)
  2. marketplace.json diff (the new stanza)
  3. Living documents touched for the count (list, old to new number)
  4. CHANGELOG entry (verbatim)
  5. Gate results (each named, pass or fail)
  6. Git and release commands (verbatim, in order)
  7. Release note (three lines a reader can paste)

Confirm to push? [the question, asked once, before step 6 runs]

Quality Checks

  • Wiring came from the scaffolder, not a hand-typed manifest
  • Every generator was run and its output committed
  • The drift check passes with the new count everywhere
  • All manifests carry the same new version
  • The CHANGELOG entry names the bundle and the skill
  • The user confirmed before anything was pushed

Anti-Patterns

  • A partial package. A skill in skills/ without the bundle, or a bundle without the count bump, breaks CI on the next push.
  • Editing generated files. They are overwritten on the next run and the diff is noise.
  • Pushing before the gates. The gates exist because the counts drift silently.
  • Reusing a tag after a failed release. Tags are immutable; bump the patch instead.

Example Trigger Phrases

  • "Publish the new skill."
  • "Release v80 with the promoted skill."
  • "Add release-notes-from-git-log to the marketplace and ship it."
  • "Run the last step of the promote loop."

© mohitagw15856, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in skills/promoter-publish of mohitagw15856/pm-claude-skills.

  • SKILL.md
  • scripts/promoter_publish.py

Open the folder on GitHubat commit 1cbf1f0

Compare with similar skills

Promoter Publish next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Promoter Publish compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Promoter Publish this skillmohitagw15856/pm-claude-skills1.4k—~1.2kAutomated safety check: PassMIT
React Router Release Notes Prepremix-run/react-router57k—~1.1kAutomated safety check: PassMIT
Draft Release Notesjamiepine/voicebox57k—~941Automated safety check: PassMIT
Mole Release Notes Publishertw93/Mole70k—~1.9kAutomated safety check: PassGPL-3.0
Release Bumpjamiepine/voicebox57k—~1.1kAutomated safety check: PassMIT
Git Workflow and Versioningaddyosmani/agent-skills105k2 repos~3.5kAutomated safety check: NotesMIT

Similar skills

  • React Router Release Notes Prep

    remix-run/react-router

    Polishes pending React Router change files before the versioning scripts run, and decides whether a long-form What's Changed section is warranted.

    57k GitHub stars~1.1k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Draft Release Notes

    jamiepine/voicebox

    Writes or refreshes the Unreleased section of CHANGELOG.md as a themed narrative built from the commits, PRs and diff since the last version tag.

    57k GitHub stars~941 tokensUpdated 4 days ago
    DevelopmentAuto-check passed
  • Publishes curated, bilingual release notes for an existing Mole version tag with gh release edit, including contributor thanks and reactions, after the release workflow finishes.

    70k GitHub stars~1.9k tokensUpdated today
    DevelopmentAuto-check passed
  • Release Bump

    jamiepine/voicebox

    Ends a release cycle by moving the Unreleased changelog notes under a dated version heading, bumping version files with bumpversion and tagging the commit.

    57k GitHub stars~1.1k tokensUpdated 4 days ago
    DevelopmentAuto-check passed
  • Git Workflow and Versioning

    addyosmani/agent-skills

    Sets git habits for every change: short-lived branches, atomic commits with descriptive messages, clean pull requests, plus versioning, tagging and changelogs for releases.

    105k GitHub starsUsed in 2 repos~3.5k tokens
    DevelopmentAuto-check: notes
  • Takes a change through a verdaccio pull request: branch, local checks, changeset, title and body, labels, CI and review rounds, and ports to other release lines.

    18k GitHub stars~1.9k tokensUpdated 2 days ago
    DevelopmentAuto-check passed

More from mohitagw15856/pm-claude-skills

All 1,348 skills in this repo
  • Car Tco

    mohitagw15856/pm-claude-skills

    Compare the total cost of car ownership across buy-new, buy-used, lease, and keep-your-current-car — depreciation, insurance, maintenance ramp, and fuel over a real horizon, not just the monthly…

    1.4k GitHub stars~1.1k tokensUpdated 2 days ago
    Auto-check passed
  • Cs Health Scorecard

    mohitagw15856/pm-claude-skills

    Build a customer health scorecard for a specific account. An agent skill from mohitagw15856/pm-claude-skills.

    1.4k GitHub stars~2.4k tokensUpdated 2 days ago
    Auto-check passed
  • Exit Waterfall

    mohitagw15856/pm-claude-skills

    Compute who gets what at each exit price from a cap table — liquidation preferences, conversion points, and where the founders' share collapses.

    1.4k GitHub stars~1.1k tokensUpdated 2 days ago
    Auto-check passed
  • Feature Prioritisation

    mohitagw15856/pm-claude-skills

    Apply prioritisation frameworks (RICE, MoSCoW, Kano, ICE, Opportunity Scoring) to rank features and backlog items.

    1.4k GitHub stars~2k tokensUpdated 2 days ago
    Auto-check passed
  • Fire Number

    mohitagw15856/pm-claude-skills

    Compute a financial-independence (FIRE) target and years-to-reach with every assumption labeled as an assumption — plus a sensitivity table instead of a single false-precision answer.

    1.4k GitHub stars~1.1k tokensUpdated 2 days ago
    Auto-check passed
  • Freelance Rate

    mohitagw15856/pm-claude-skills

    Derive a freelance day/hourly rate backwards from target income, honest billable utilization, overhead, and the self-employment tax premium — the arithmetic that proves a rate is not salary÷2000.

    1.4k GitHub stars~1.2k tokensUpdated 2 days ago
    Auto-check passed

Works with

Categories

Questions about Promoter Publish

What does Promoter Publish do?

Register a finished skill in this library and produce the complete release package: the bundle wiring and marketplace entry, the regenerated catalogue and exports, the headline count in every living…. Promoter Publish is an agent skill from mohitagw15856/pm-claude-skills. Register a finished skill in this library and produce the complete release package: the bundle wiring and marketplace entry, the regenerated catalogue and exports, the headline count in every living document, the CHANGELOG entry, the gates to run, and the exact git and release commands.

When should I use Promoter Publish?

Promoter Publish fits situations like: asked to publish this skill; release the new skill; add it to the marketplace; ship the promoted skill.

How do I install Promoter Publish in Claude Code?

Run `npx skills add mohitagw15856/pm-claude-skills --skill promoter-publish -a claude-code`. Or copy the skill folder (skills/promoter-publish in mohitagw15856/pm-claude-skills) into .claude/skills/promoter-publish in your project. Claude Code loads it when a task matches its description.

How do I install Promoter Publish in Codex?

Run `npx skills add mohitagw15856/pm-claude-skills --skill promoter-publish -a codex`. Or copy the skill folder (skills/promoter-publish in mohitagw15856/pm-claude-skills) into .agents/skills/promoter-publish in your project. Codex loads it when a task matches its description.

Can I use Promoter Publish in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mohitagw15856/pm-claude-skills --skill promoter-publish -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/promoter-publish, .gemini/skills/promoter-publish, .github/skills/promoter-publish and .opencode/skills/promoter-publish in your project.

What does Promoter Publish need to run?

Going by SKILL.md and its folder, Promoter Publish needs Python for the scripts in its folder and the command-line tools its instructions call (python3 and node). Our summary lists: Python 3.

Does Promoter Publish access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Promoter Publish safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Promoter Publish use?

Promoter Publish is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Promoter Publish use?

About 1.2k tokens (SKILL.md is roughly 4.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Promoter Publish?

Skills that share tags, products or a category with Promoter Publish: React Router Release Notes Prep (remix-run/react-router, 57k stars), Draft Release Notes (jamiepine/voicebox, 57k stars), Mole Release Notes Publisher (tw93/Mole, 70k stars) and Release Bump (jamiepine/voicebox, 57k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Promoter Publish?

mohitagw15856 (a GitHub user) maintains it in mohitagw15856/pm-claude-skills, which has 1,434 GitHub stars. The repository holds 1,348 skills in this directory. The repository was last updated on October 9, 2026.

Source: mohitagw15856/pm-claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.