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

Good fit Use it before publishing, open-sourcing, or sharing a local skill.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/hqhq1025/skill-optimizer/skill-generalizer
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.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.svg" alt="Measured on agentmods" 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 $0.00026 $0.00254
Sonnet 5 $0.00010 $0.00102
Haiku 4.5 $0.00005 $0.00051

Measured 7d ago against content hash 82ac835278ba, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-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 7d 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. 7d 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 (165 stars, last pushed 3mo ago), licensed MIT. It adds 52 tokens to every session and 508 once invoked, about $0.0003 per session on Opus 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.

Related

Other skills, from other repositories

forward-implementation-first

Keeps an agent building and validating real output instead of servicing its own bookkeeping. Use for multi-stage pipelines, capability roadmaps, long-running implementation loops, migrations, staged data or build runs, and any run where administrative hashes, locks, receipts, dashboards, certification markers, or…

Vuk97/forward-implementation-first · 94 tokens

pingpong

Spontaneous local leisure meetups via a shared agent board: publish, discover and match offers, then negotiate place & time agent-to-agent. ALWAYS use this skill when the user spontaneously wants to do something or says: "publish an offer", "I want to play table tennis / X", "fancy a ...", "who's free for ...", "find…

0xAaronx0/pingpong · 121 tokens

master-instructional-design

Expert instructional design coach and auditor. Activate for: instructional design, eLearning, storyboard, learning objective, ADDIE, SAM, curriculum design, needs analysis, task analysis, Agile/Scrum for L&D, LXD, learner journey, ATD capability model, CPTD, authoring tools (Storyline, Rise, Captivate, Lectora…

narosemena/master-instructional-design · 230 tokens

experimental-design

Best practices for designing reproducible ML experiments. Use when planning ablations, baselines, or controlled experiments.

aiming-lab/AutoResearchClaw · 25 tokens

vox-director

Turn ONE topic into a finished Vox-style paper-collage explainer / ad video, end to end on the Atlas Cloud API + local ffmpeg — script, collage keyframes, motion, voice-over, music, captions, all automated. Use this whenever the user wants a "Vox style" video, a paper/torn-paper collage animation, a "motion collage"…

Alisa0808/vox-director · 236 tokens

ops-demo

CocoOps demo mode activator — populates .cocoplus/ops/demo/ with realistic mock data and sets cocoplus.toml [demo] enabled = true. Invoked via $ops demo.

Snowflake-Labs/cocoplus · 46 tokens