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.
1---2name: skill-generalizer3description: 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.4---5
6# Skill Generalizer
7
8## Overview
9
10Convert 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.
11
12## When To Use
13
14- A user wants to publish, share, promote, open-source, or package a local skill.
15- A skill was born from personal workflows, private repos, local paths, transcripts, remote hosts, or team conventions.
16- The output needs to be useful to strangers without leaking the author's environment.
17
18Do not use for tuning a skill only for the user's own machine; use `skill-personalizer` for that.
19
20## Workflow
21
221. Inspect the actual source skill and nearby repo files before judging.
232. If the source skill quality is unclear, run the audit checks from `skill-personalizer` first.
243. Separate the reusable capability from personal implementation details.
254. Redact or replace private names, paths, hosts, credentials, account IDs, transcripts, and one-off project facts.
265. Rewrite the skill around general triggering conditions, portable workflows, and bounded assumptions.
276. Keep `SKILL.md` concise; move long rubrics, examples, or scripts into bundled resources.
287. Check target-agent compatibility before writing install instructions or support claims.
298. Produce publication-ready packaging and honest promotion copy only when requested.
309. Verify frontmatter, file layout, install path, and at least one realistic usage prompt.
31
32## Public Release Rules
33
34- Frontmatter `description` should describe when to use the skill, not summarize its workflow.
35- Public examples must be generic or explicitly sanitized.
36- Claims in README or marketplace copy must match files that actually exist.
37- Prefer portable commands and path placeholders over the author's home directory or private aliases.
38- If a personal detail is essential, turn it into a configurable variable with setup guidance.
39
40## References
41
42Read [publication-rubric.md](references/publication-rubric.md) when doing a full release pass, redaction review, README rewrite, or promotional packaging.
43
44Read [platform-compatibility.md](references/platform-compatibility.md) before claiming support for Codex, Claude Code, Cursor, OpenCode, Gemini CLI, or other coding agents.
aibot88