Skip to content

feiskyer/claude-code-settings / skills/skill-creator

skill-creator

Verified

Create, refine, and benchmark agent skills. Use when building a new skill, updating an existing one, running evals, checking trigger quality, or improving a skill description.

FileKindSize
LICENSE.txtmarkdown11.1 KB
README.mdmarkdown462 B
SKILL.mdskill md30.0 KB
agents/analyzer.mdmarkdown10.4 KB
agents/comparator.mdmarkdown6.9 KB
agents/grader.mdmarkdown9.1 KB
assets/eval_review.htmlother6.9 KB
eval-viewer/generate_review.pyscript16.0 KB
eval-viewer/viewer.htmlother43.9 KB
references/schemas.mdmarkdown11.6 KB
scripts/__init__.pyscript0 B
scripts/aggregate_benchmark.pyexecutablescript14.5 KB
scripts/generate_report.pyexecutablescript13.0 KB
scripts/improve_description.pyscript16.2 KB
scripts/package_skill.pyexecutablescript4.1 KB
scripts/platforms/__init__.pyscript54 B
scripts/platforms/base.pyscript2.2 KB
scripts/platforms/claude_code.pyscript6.3 KB
scripts/platforms/codex.pyscript5.4 KB
scripts/platforms/openclaw.pyscript4.3 KB
scripts/quick_validate.pyscript9.6 KB
scripts/run_eval.pyexecutablescript8.2 KB
scripts/run_loop.pyexecutablescript15.0 KB
scripts/utils.pyscript3.4 KB

scripts/utils.py

View on GitHub
"""Shared utilities for skill-creator scripts."""

import ast
import json
import re
from pathlib import Path

_FRONTMATTER_RE = re.compile(r"^---\n(.*?)\n---\n?", re.DOTALL)


def _coerce_frontmatter_value(raw_value: str):
    """Parse a simple scalar or inline collection from frontmatter."""
    value = raw_value.strip()
    if value.lower() == "true":
        return True
    if value.lower() == "false":
        return False
    if value.lower() in {"null", "~"}:
        return None
    if len(value) >= 2 and value[0] == value[-1] and value[0] in {'"', "'"}:
        return value[1:-1]
    if value.startswith("{") or value.startswith("["):
        for loader in (json.loads, ast.literal_eval):
            try:
                return loader(value)
            except Exception:
                continue
    return value


def parse_top_level_yaml_text(text: str) -> dict:
    """Parse a lightweight top-level YAML-like mapping."""
    frontmatter: dict = {}
    lines = text.splitlines()
    index = 0

    while index < len(lines):
        line = lines[index]
        if not line.strip() or line.lstrip().startswith("#"):
            index += 1
            continue
        if line.startswith((" ", "\t")):
            index += 1
            continue
        if ":" not in line:
            raise ValueError(f"Invalid frontmatter line: {line}")

        key, raw_value = line.split(":", 1)
        key = key.strip()
        value = raw_value.strip()

        if value in {"|", ">", "|-", ">-"}:
            continuation: list[str] = []
            index += 1
            while index < len(lines) and lines[index].startswith((" ", "\t")):
                continuation.append(lines[index].strip())
                index += 1
            if value.startswith(">"):
                frontmatter[key] = " ".join(continuation).strip()
            else:
                frontmatter[key] = "\n".join(continuation).strip()
            continue

        if value == "":
            nested_lines: list[str] = []
            index += 1
            while index < len(lines) and lines[index].startswith((" ", "\t")):
                nested_lines.append(lines[index])
                index += 1
            frontmatter[key] = "\n".join(nested_lines).strip()
            continue

        frontmatter[key] = _coerce_frontmatter_value(value)
        index += 1

    return frontmatter


def load_skill_frontmatter(skill_path: Path) -> tuple[dict, str, str]:
    """Load SKILL.md frontmatter as a lightweight top-level mapping."""
    content = (skill_path / "SKILL.md").read_text()
    match = _FRONTMATTER_RE.match(content)
    if not match:
        raise ValueError("SKILL.md missing valid YAML frontmatter")

    frontmatter_text = match.group(1)
    frontmatter = parse_top_level_yaml_text(frontmatter_text)
    return frontmatter, frontmatter_text, content


def parse_skill_md(skill_path: Path) -> tuple[str, str, str]:
    """Parse a SKILL.md file, returning (name, description, full_content)."""
    frontmatter, _, content = load_skill_frontmatter(skill_path)
    name = frontmatter.get("name", "")
    description = frontmatter.get("description", "")

    if not isinstance(name, str):
        raise ValueError("SKILL.md frontmatter field 'name' must be a string")
    if not isinstance(description, str):
        raise ValueError("SKILL.md frontmatter field 'description' must be a string")

    return name.strip(), description.strip(), content
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 467kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 319kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 319kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 319kUpdated Claude CodeCodexVerifiedInstall