agentmods.dev

skill-generalizer

skill-generalizer is a skill for Claude Code, Codex from hqhq1025/skill-optimizer. It costs 52 tokens per session (508 once invoked), scanned A, original, MIT.

A method for turning a private Agent Skill into a version that can be shared publicly or with a team. It keeps the reusable workflow while removing personal paths, credentials, internal names, and machine-specific details.

In plain words
What is it for?
Use it before publishing, open-sourcing, or sharing a local skill. It helps inspect the original files, rewrite assumptions, move large supporting material into resources, and check the result.
Why use it?
A skill built for one computer or organization may expose private information or fail for other users. Generalizing it makes the instructions safer and more portable.

Skill for Claude CodeCodex

Written for Claude Code and Codex: shipped in a Claude Code plugin, but also agents/openai.yaml present. Also seen: mentions Claude Code; mentions Codex; mentions Gemini CLI.

Part of the skill-optimizer plugin — 3 skills shipped together

not rated 190repo +3 5mo ago A scan 52 tokens original MIT

Good fit Use it before publishing, open-sourcing, or sharing a local skill. It helps inspect the original files, rewrite assumptions, move large supporting material into resources, and check the result.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/hqhq1025/skill-optimizer/skill-generalizer
View source ↗ hqhq1025/skill-optimizer hqhq1025.github.io
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add hqhq1025/skill-optimizer --skill skill-generalizer
Clone the repo
git clone --depth 1 https://github.com/hqhq1025/skill-optimizer

Made for: Claude Code, Codex.

Or install skill-optimizer, the plugin that ships this one along with the rest of its 3 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for skill-generalizer

README.md
[![agentmods](https://agentmods.dev/badge/skills/hqhq1025/skill-optimizer/skill-generalizer/github.svg)](https://agentmods.dev/skills/hqhq1025/skill-optimizer/skill-generalizer)
Your own site
<a href="https://agentmods.dev/skills/hqhq1025/skill-optimizer/skill-generalizer"><img src="https://agentmods.dev/badge/skills/hqhq1025/skill-optimizer/skill-generalizer/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for skill-generalizer

Your own site · 80×15
<a href="https://agentmods.dev/skills/hqhq1025/skill-optimizer/skill-generalizer"><img src="https://agentmods.dev/badge/skills/hqhq1025/skill-optimizer/skill-generalizer.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 52 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 508 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00052 $0.00508
Opus 5.5 $0.00021 $0.00203
Sonnet 5.5 $0.00010 $0.00102
Haiku 4.5 $0.00005 $0.00051

Measured 2mo ago against content hash 82ac835278ba, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

skill-generalizer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/skill-generalizer/SKILL.md · 45 lines

How it starts

The opening of the file, as written. The whole thing — 45 lines — stays where its author put it; the contents beside it link to each section on GitHub.

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 the full file on GitHub · 45 lines

Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2mo ago First seen · 45 lines · 52 tokens per session scan A 82ac835278ba

Subscribe to this mod's changes

skill-generalizer is a skill published in the GitHub repository hqhq1025/skill-optimizer (190 stars, last pushed 5mo ago), licensed MIT. It adds 52 tokens to every session and 508 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Building agentsClaude Codeagent-skillsagentskillsclaude-skillcodexllm-agents
Related

skill-generalizer compared with skills from other repositories

skill-generalizer next to 6 skills from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
skill-generalizerhqhq1025/skill-optimizerSkill1905mo agoMITA52Claude Code, Codex
forward-implementation-firstVuk97/forward-implementation-firstSkill1842mo agoMITC94Claude Code, Codex
pingpong0xAaronx0/pingpongSkill64mo agoMITA121Claude Code, Codex
master-instructional-designnarosemena/master-instructional-designSkill246mo agononeA230Claude Code, Codex
vox-directorAlisa0808/vox-directorSkill2.6k1mo agoMITA236Claude Code, Codex
higgsfield-troubleshootOSideMedia/higgsfield-ai-prompt-skillSkill86313d agoMITA39Claude Code
akg-agentsXiaoLuoLYG/GODSkill1.3k14d agoApache-2.0A75Claude Code, Codex