skill auto improver

Security Community

Skill notes

Repo Sync Before Edits (mandatory)

This skill mutates files in a git repo. Before any edit, sync the local branch with the remote: If the working tree is dirty, git stash, sync, then git stash pop. If origin is missing or git pull hits conflicts, stop and ask the user before continuing — do not skip or force the sync.

When to Use

The user asks to "improve", "level up", "fix", "polish", or "bring up to standard" an existing skill A skill fails quick_validate.py or scores below the asm-eval 85/8 floor and must ship You are preparing a skill for asm publish or inclusion in a catalog You want to dogfood quality improvements on one of your own skills If the user only wants a report without edits, run asm eval <path> and python scripts/quick_validate.py <path> directly — that is not this skill. If the user is authoring a brand-new skill from scratch, send them to /skill-creator instead — this skill assumes a SKILL.md already exists.

Prerequisites

Verify all of the following before touching any files. Stop and tell the user if any fails. asm is available on PATH (command -v asm or which asm) Python 3 is available, and ~/.claude/skills/skill-creator/scripts/quick_validate.py exists (skill-creator must be installed locally) The target skill path contains a SKILL.md file The working tree has no unrelated uncommitted edits (dirty files get mixed into diffs)

Inputs

The user provides one of: A local skill path: skills/foo or /abs/path/to/skill A direct SKILL.md file path (treated as its parent directory) A GitHub shorthand: github:owner/repo or github:owner/repo:path/to/skill For GitHub inputs, ask the user to clone locally first or whether you should open a PR back to that repo. This skill's default path is local editing — remote editing is out of scope for v1.

Gate 1 — Skill-creator standard (must-pass floor)

A skill passes this gate when all of these are true: python "$QV" "$SKILL_PATH" exits 0 (no unexpected keys, name is kebab-case ≤64 chars, description is single-line ≤1024 chars, etc.) The Frontmatter Audit (full checklist in references/frontmatter-audit.md) passes SKILL.md body is under 500 lines (split to references/ if not) Description includes a negative-trigger clause naming adjacent domains that should not trigger the skill (quick_validate.py warns when missing)

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
Security
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
94 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@luongnv89 · MIT
Token usage
Heavy
Setup complexity
Guided setup
External API key
Not required
Operating systems
Unspecified (assume cross-platform)
Runtime requirements
Python
Detected file/system behavior
  • Read-only
  • Write / modify
  • Shell exec
Network behavior
External requests
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

Output preview skill-auto-improver.preview
# Expected output

See `references/report-template.md` for the full PASS and BLOCKER report templates. On BLOCKER, include a `## Blockers` section naming each failing gate check with a one-line reason.

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.