Agent skill

Publish Skill

by alexanderop in alexanderop/walkthrough

Creates a new GitHub repository for a Claude Code skill with proper README and directory structure.

No licenceAuto-check: notesDevelopment

Install Publish Skill

skills CLI
$ npx skills add alexanderop/walkthrough --skill publish-skill -a claude-code

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

GitHub CLI
$ gh skill install alexanderop/walkthrough publish-skill --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/alexanderop/walkthrough.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/publish-skill .claude/skills/publish-skill && 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
publish-skill
GitHub stars
141
Token cost
~1.2k tokens
SKILL.md length
381 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
None found

At a glance

Creates a new GitHub repository for a Claude Code skill with proper README and directory structure.

  • Works in 5 steps: Gather skill information → Create the repository structure → Generate the README → …
  • You want to package and publish a skill so others can install it
  • SKILL.md covers Workflow and Quality Checklist
  • Calls git, npx and gh; reaches github.com

What it does

Publish Skill is an agent skill from alexanderop/walkthrough. Creates a new GitHub repository for a Claude Code skill with proper README and directory structure. Use when you want to package and publish a skill so others can install it. Triggers on "publish skill", "publish this skill", "create skill repo", "package skill", "share this skill".

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Claude Code CLI. Requires gh CLI authenticated with GitHub.

It sits in Development, covering Technical documentation. It works with GitHub. The repository describes itself as: A Claude Code skill that generates interactive HTML walkthroughs with clickable Mermaid diagrams to explain codebase features, flows, and architecture.

When your agent uses it

  • You want to package and publish a skill so others can install it
  • Publish this skill
  • Create skill repo
  • Share this skill

Example prompts

  • “publish skill”
  • “publish this skill”
  • “create skill repo”
  • “/publish-skill”

Requirements

  • Node.js
  • Compatibility (from SKILL.md): Claude Code CLI. Requires `gh` CLI authenticated with GitHub.
  • Pre-approved tools (allowed-tools): Bash, Read, Write, Glob, Grep, Task, AskUserQuestion

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Gather skill information
  2. Create the repository structure
  3. Generate the README
  4. Initialize git and publish
  5. Report back

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Write
    • Glob
    • Grep
    • Task
    • AskUserQuestion

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • npx
    • gh

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    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.

  • Compatibility

    Claude Code CLI. Requires `gh` CLI authenticated with GitHub.

    From compatibility in the SKILL.md frontmatter.

Context cost

Publish Skill loads about 1.2k tokens when it runs. Until then it costs about 74 tokens; SKILL.md has 381 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~74
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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Write, Glob, Grep, Task, AskUserQuestion

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); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 381 words (~1,185 tokens).

“Package a Claude Code skill into a new GitHub repository with a polished README and proper directory structure — ready for others to install with npx skills add.”

— opening of SKILL.md by alexanderop
name
publish-skill
allowed-tools
Bash, Read, Write, Glob, Grep, Task, AskUserQuestion
compatibility
Claude Code CLI. Requires `gh` CLI authenticated with GitHub.
metadata.author
Alexander Opalic
metadata.version
1.0

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/publish-skill of alexanderop/walkthrough.

Open the folder on GitHubat commit 5e70c06

Compare with similar skills

Publish Skill 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.

Publish Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Publish Skill this skillalexanderop/walkthrough141—~1.2kAutomated safety check: NotesNone
Update .NET OS Packagesdotnet/core22k—~2.3kAutomated safety check: PassMIT
Beautify GitHub Readmeoil-oil/beautify-github-readme1.8k—~4.1kAutomated safety check: PassMIT
Update .NET Supported OS Matrixdotnet/core22k—~4.1kAutomated safety check: PassMIT
Debate ReviewamElnagdy/review-skills1322 repos~986Automated safety check: PassMIT
Library Documentation Seekerwithkynam/vibecode-pro-max-kit1.1k1 repos~1kAutomated safety check: NotesMIT

Similar skills

  • Official

    Audits and updates os-packages.json files listing the Linux packages each .NET release needs per distro, then regenerates the Markdown from the JSON.

    22k GitHub stars~2.3k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Beautify GitHub Readme

    oil-oil/beautify-github-readme

    Redesign GitHub README homepages or create project-native pure SVG, hybrid SVG-composed PNG/WebP, and opt-in animated GIF assets.

    1.8k GitHub stars~4.1k tokensUpdated 5 days ago
    DevelopmentAuto-check passed
  • Official

    Audits and updates the supported-os.json files for .NET releases, checking them against upstream lifecycle data and regenerating the markdown with the release-notes tool.

    22k GitHub stars~4.1k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Debate Review

    amElnagdy/review-skills

    Two-model debate review of a GitHub PR, GitLab MR, Azure DevOps PR, or local working tree, posted as inline comments or printed.

    132 GitHub starsUsed in 2 repos~986 tokens
    DevelopmentAuto-check passed
  • Library Documentation Seeker

    withkynam/vibecode-pro-max-kit

    Looks up library and framework documentation through Context7 first, with bundled Node scripts as a fallback that fetch and analyze llms.txt files.

    1.1k GitHub starsUsed in 1 repo~1k tokens
    DevelopmentAuto-check: notes
  • Post Draft Review

    agent-substrate/substrate

    Posts pull request review findings as GitHub draft (pending) inline comments for a human to edit and submit, instead of publishing them straight to the PR author.

    4.6k GitHub stars~2.8k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from alexanderop/walkthrough

  • Walkthrough

    alexanderop/walkthrough

    Generates a self-contained HTML file with an interactive, clickable Mermaid diagram (flowchart or ER diagram) that explains how a codebase feature, flow, architecture, or database schema works.

    141 GitHub stars~3.4k tokensUpdated 6 mo ago
    Auto-check: notes

Works with

Categories

Questions about Publish Skill

What does Publish Skill do?

Creates a new GitHub repository for a Claude Code skill with proper README and directory structure. Publish Skill is an agent skill from alexanderop/walkthrough. Creates a new GitHub repository for a Claude Code skill with proper README and directory structure.

When should I use Publish Skill?

Publish Skill fits situations like: you want to package and publish a skill so others can install it; publish this skill; create skill repo; share this skill.

How do I install Publish Skill in Claude Code?

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

How do I install Publish Skill in Codex?

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

Can I use Publish Skill 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 alexanderop/walkthrough --skill publish-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/publish-skill, .gemini/skills/publish-skill, .github/skills/publish-skill and .opencode/skills/publish-skill in your project.

What does Publish Skill need to run?

Going by SKILL.md and its folder, Publish Skill needs the command-line tools its instructions call (git, npx and gh). Our summary lists: Node.js. Its frontmatter pre-approves these tools: Bash, Read, Write, Glob, Grep, Task, AskUserQuestion. Compatibility (from SKILL.md): Claude Code CLI. Requires `gh` CLI authenticated with GitHub..

Does Publish Skill access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Publish Skill safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Publish Skill use?

No licence was found for Publish Skill or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Publish Skill use?

About 1.2k tokens (SKILL.md is roughly 4.7k 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 Publish Skill?

Skills that share tags, products or a category with Publish Skill: Update .NET OS Packages (dotnet/core, 22k stars), Beautify GitHub Readme (oil-oil/beautify-github-readme, 1.8k stars), Update .NET Supported OS Matrix (dotnet/core, 22k stars) and Debate Review (amElnagdy/review-skills, 132 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Publish Skill?

alexanderop (a GitHub user) maintains it in alexanderop/walkthrough, which has 141 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on March 23, 2026.

Source: alexanderop/walkthrough on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.