mcpField
S
skill-manager

skill-manager

github.com/melvynxAgent workflows24343 installsUpdated 1w ago
Repository

About skill-manager

A skill for creating and auditing concise skills for Claude, Codex, or Cursor. It gives a short process for confirming triggers, selecting a platform, drafting instructions, and checking descriptions.

Key features

  1. 01Platform selection guidance
  2. 02Trigger confirmation process
  3. 03Frontmatter and body structure
  4. 04Line-by-line skill auditing
  5. 05Description inspection command

Use cases

  1. 01Creating a personal skill
  2. 02Adapting a skill to a platform
  3. 03Removing redundant skill instructions
  4. 04Checking a skill description

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/melvynx/aiblueprint --skill skill-manager

After installing, type/skill-managerin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
openai.yaml
assets/
codex-icon.svg
references/
claude-code.md
codex.md
cursor.md
description-recommandation.md
skill-writing-glossary.md
scripts/
inspect-description.ts
setup-codex-icons.ts

Details

From the project README

Write skills the way $analyze, $plan, $implement, $code-review, and $verify are written.

Target

  • One job. Imperative. Every line changes behavior.
  • Body under ~40 lines unless the job is genuinely multi-branch.
  • Description 50–300 chars: capability first, then Use when + trigger words.
  • No README, changelog, or theory. No restating model defaults.
  • References only for platform or schema detail the body cannot hold. Name the file and when to open it.
  • User-only workflows: disable-model-invocation: true.

Write

  1. Confirm 2–3 trigger prompts with the user.
  2. Pick the platform. Default from the path: .claude → Claude, .agents → Codex, .cursor → Cursor. Ask if unclear.
  3. Write frontmatter, then the body: inspect → act → return → stop.
  4. Run bun ~/.agents/skills/skill-manager/scripts/inspect-description.ts on the skill root.

Personal skills live in ~/.agents/skills/<name>/. Platform layout and frontmatter: claude-code.md, codex.md, cursor.md. Description rules: description-recommandation.md.

Audit

For each line: would removing it change behavior? Delete no-ops, duplicates, and stale rules. State the positive target; keep prohibitions only as hard guardrails.

Online research: $find-docs for current technical docs; $exa-search for broader web research.

After creating or renaming a personal skill icon, run bun ~/.agents/scripts/sync-codex-profile-icons.ts --install. Compat: ~/.claude/skills and ~/.codex/skills symlink to ~/.agents/skills. Do not symlink ~/.cursor/skills.

Comments

Markdown supported