Skill Generalizer Agent Skill

Use when turning local, private, or personal Agent Skills into publishable skills for GitHub, marketplaces, teams, or public sharing, especially when private paths, personal habits, credentials, internal hosts, or user-specific context must be removed.

2k tokens

context cost

the whole folder, loaded on every use

files

instructions only

copies elsewhere

how many repositories repackaged it

152

stars on the repo

on the repository, not the skill itself

Install

one command, takes just this skill from the repository

npx skills add https://github.com/hqhq1025/skill-optimizer --skill skill-generalizer

The instruction itself

6 sections, as written by the author

Skill Generalizer

Overview

Convert a working local skill into a clean public artifact. The goal is to preserve the reusable technique while removing private context, personal assumptions, and machine-specific setup.

When To Use

A user wants to publish, share, promote, open-source, or package a local skill.
A skill was born from personal workflows, private repos, local paths, transcripts, remote hosts, or team conventions.
The output needs to be useful to strangers without leaking the author's environment.

Do not use for tuning a skill only for the user's own machine; use skill-personalizer for that.

Workflow

Inspect the actual source skill and nearby repo files before judging.
If the source skill quality is unclear, run the audit checks from skill-personalizer first.
Separate the reusable capability from personal implementation details.
Redact or replace private names, paths, hosts, credentials, account IDs, transcripts, and one-off project facts.
Rewrite the skill around general triggering conditions, portable workflows, and bounded assumptions.
Keep SKILL.md concise; move long rubrics, examples, or scripts into bundled resources.
Check target-agent compatibility before writing install instructions or support claims.
Produce publication-ready packaging and honest promotion copy only when requested.
Verify frontmatter, file layout, install path, and at least one realistic usage prompt.

Public Release Rules

Frontmatter description should describe when to use the skill, not summarize its workflow.
Public examples must be generic or explicitly sanitized.
Claims in README or marketplace copy must match files that actually exist.
Prefer portable commands and path placeholders over the author's home directory or private aliases.
If a personal detail is essential, turn it into a configurable variable with setup guidance.

References

Read publication-rubric.md when doing a full release pass, redaction review, README rewrite, or promotional packaging.

Read platform-compatibility.md before claiming support for Codex, Claude Code, Cursor, OpenCode, Gemini CLI, or other coding agents.

Other skills for the same job

different authors, same section of the catalogue

Skill Creator

by anthropics

vendor ×10

Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.

Replace with description of the skill and when Claude should use it.

35 tokens

Dispatching Parallel Agents

by ZhanlinCui

×5

Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies

This skill should be used when the user wants to "create a skill", "add a skill to plugin", "write a new skill", "improve skill description", "organize skill content", or needs guidance on skill structure, progressive disclosure, or skill development best practices for Claude Code plugins.

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

Use when creating new skills, editing existing skills, or verifying skills work before deployment

26k tokens scripts

How to use it

Copy the folder

Take hqhq1025/skill-generalizer from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.