Agent skill

Skill Generalizer

by hqhq1025 in hqhq1025/skill-optimizer

A skill your agent uses when turning local, private, or personal Agent Skills into publishable skills for GitHub, marketplaces, teams, or public sharing, especially when private paths, personal…

MITAuto-check passedEducation

Install Skill Generalizer

skills CLI
$ npx skills add hqhq1025/skill-optimizer --skill skill-generalizer -a claude-code

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

GitHub CLI
$ gh skill install hqhq1025/skill-optimizer skill-generalizer --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/hqhq1025/skill-optimizer.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/skill-generalizer .claude/skills/skill-generalizer && 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
skill-generalizer
GitHub stars
181
Token cost
~641 tokens
SKILL.md length
306 words
Files
4 (incl. references)
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when turning local, private, or personal Agent Skills into publishable skills for GitHub, marketplaces, teams, or public sharing, especially when private paths, personal…

  • Works in 9 steps: Inspect the actual source skill and… → If the source skill quality is unclear,… → Separate the reusable capability from… → …
  • Personal Agent Skills into publishable skills for GitHub
  • SKILL.md covers Overview, When To Use, Workflow and Public Release Rules, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Skill Generalizer is an agent skill from hqhq1025/skill-optimizer. 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.

Its SKILL.md is about 640 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `agents/openai.yaml`, `references/platform-compatibility.md` and `references/publication-rubric.md`).

It sits in Education, covering AI search optimization and Skill management. It works with GitHub. The repository describes itself as: Agent Skills lifecycle toolkit: mine repeated coding-agent workflows, audit and personalize skills, and generalize personal skills for public release. The licence is MIT.

When your agent uses it

  • Personal Agent Skills into publishable skills for GitHub
  • Especially when private paths
  • Personal habits
  • User-specific context must be removed

Example prompts

  • “/skill-generalizer”

Workflow steps

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

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

What it can do on your machine

Read from SKILL.md and the folder at commit b9ffd15. 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

    No scripts in the folder and no shell commands in SKILL.md.

    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

Skill Generalizer loads about 641 tokens when it runs, and up to ~1.9k if it reads all its reference files. Until then it costs about 68 tokens; SKILL.md has 306 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~68
When it runs · the whole SKILL.md, loaded when a task matches
~641
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.9k

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

SKILL.md

The full file from hqhq1025/skill-optimizer at commit b9ffd15, republished under its MIT licence (© hqhq1025). 306 words, ~641 tokens.

Download SKILL.mdSave it as .claude/skills/skill-generalizer/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
skill-generalizer
description
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.

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

  1. Inspect the actual source skill and nearby repo files before judging.
  2. If the source skill quality is unclear, run the audit checks from skill-personalizer first.
  3. Separate the reusable capability from personal implementation details.
  4. Redact or replace private names, paths, hosts, credentials, account IDs, transcripts, and one-off project facts.
  5. Rewrite the skill around general triggering conditions, portable workflows, and bounded assumptions.
  6. Keep SKILL.md concise; move long rubrics, examples, or scripts into bundled resources.
  7. Check target-agent compatibility before writing install instructions or support claims.
  8. Produce publication-ready packaging and honest promotion copy only when requested.
  9. 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.

© hqhq1025, 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 3 other files (references) in skills/skill-generalizer of hqhq1025/skill-optimizer.

  • SKILL.md
  • agents/openai.yaml
  • references/platform-compatibility.md
  • references/publication-rubric.md

Open the folder on GitHubat commit b9ffd15

Compare with similar skills

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

Skill Generalizer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Skill Generalizer this skillhqhq1025/skill-optimizer181—~641Automated safety check: PassMIT
SEOBhanunamikaze/Agentic-SEO-Skill960—~4.9kAutomated safety check: NotesMIT
Build Backlinksonvoyage-ai/gtm-engineer-skills1.3k—~2.3kAutomated safety check: PassMIT
Docs Seekereinverne/dotfiles121—~1.4kAutomated safety check: PassGPL-3.0
GitHubkostja94/marketing-skills1k—~4.5kAutomated safety check: PassMIT
GitHub Readmethatrebeccarae/claude-marketing161—~2.9kAutomated safety check: PassMIT

Similar skills

  • SEO

    Bhanunamikaze/Agentic-SEO-Skill

    Deterministic LLM-first SEO audits for websites, blog posts, and GitHub repositories.

    960 GitHub stars~4.9k tokensUpdated 2 mo ago
    Marketing & SEOAuto-check: notes
  • Build Backlinks

    onvoyage-ai/gtm-engineer-skills

    Finds free backlink and brand mention opportunities across Hacker News, Quora, GitHub, directories, and niche communities.

    1.3k GitHub stars~2.3k tokensUpdated 4 mo ago
    Marketing & SEOAuto-check passed
  • Docs Seeker

    einverne/dotfiles

    Searching internet for technical documentation using llms.txt standard, GitHub repositories via Repomix, and parallel exploration.

    121 GitHub stars~1.4k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • GitHub

    kostja94/marketing-skills

    When the user wants to use GitHub for SEO, parasite SEO, GEO, open source marketing, README optimization, or curated Awesome lists.

    1k GitHub stars~4.5k tokensUpdated 4 days ago
    Marketing & SEOAuto-check passed
  • GitHub Readme

    thatrebeccarae/claude-marketing

    Generate, audit, or update GitHub READMEs with project-type-aware structure, voice calibration, and SEO/AEO discoverability guidance.

    161 GitHub stars~2.9k tokensUpdated 4 mo ago
    Marketing & SEOAuto-check passed
  • Generative Engine Optimization

    kostja94/marketing-skills

    When the user wants to optimize for AI search visibility (ChatGPT, Claude, Perplexity, AI Overviews).

    1k GitHub stars~2.9k tokensUpdated 4 days ago
    Marketing & SEOAuto-check passed

More from hqhq1025/skill-optimizer

  • Skill Miner

    hqhq1025/skill-optimizer

    A skill your agent uses when mining coding-agent session history, archived transcripts, memories, or repeated local work to discover recurring workflows that should become new Agent Skills.

    181 GitHub stars~719 tokensUpdated 4 mo ago
    Auto-check passed
  • Skill Personalizer

    hqhq1025/skill-optimizer

    A skill your agent uses when auditing or adapting newly created, downloaded, forked, installed, or community Agent Skills to the user's tools, habits, directories, session history, and preferred…

    181 GitHub stars~630 tokensUpdated 4 mo ago
    Auto-check passed

Works with

Questions about Skill Generalizer

What does Skill Generalizer do?

A skill your agent uses when turning local, private, or personal Agent Skills into publishable skills for GitHub, marketplaces, teams, or public sharing, especially when private paths, personal…. Skill Generalizer is an agent skill from hqhq1025/skill-optimizer. 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.

When should I use Skill Generalizer?

Skill Generalizer fits situations like: personal Agent Skills into publishable skills for GitHub; especially when private paths; personal habits; user-specific context must be removed.

How do I install Skill Generalizer in Claude Code?

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

How do I install Skill Generalizer in Codex?

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

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

What does Skill Generalizer need to run?

SKILL.md names no scripts, command-line tools or credentials: Skill Generalizer is instructions for the agent only.

Does Skill Generalizer 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 Skill Generalizer 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. Review the folder before installing.

What licence does Skill Generalizer use?

Skill Generalizer 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 Skill Generalizer use?

About 641 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.3k tokens, read only when the agent opens those files.

What are the alternatives to Skill Generalizer?

Skills that share tags, products or a category with Skill Generalizer: SEO (Bhanunamikaze/Agentic-SEO-Skill, 960 stars), Build Backlinks (onvoyage-ai/gtm-engineer-skills, 1.3k stars), Docs Seeker (einverne/dotfiles, 121 stars) and GitHub (kostja94/marketing-skills, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Skill Generalizer?

hqhq1025 (a GitHub user) maintains it in hqhq1025/skill-optimizer, which has 181 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on May 14, 2026.

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