Skip to content

aiskillstore/marketplace / skills/89jobrien/skill-creator

skill-creator

Verified

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.

FileKindSize
LICENSE.txtmarkdown11.1 KB
SKILL.mdskill md11.6 KB
references/SUBAGENT.template.mdmarkdown2.0 KB
references/agent-skill.template.mdmarkdown2.6 KB
scripts/init-skill.pyexecutablescript10.6 KB
scripts/package-skill.pyexecutablescript3.2 KB
scripts/quick-validate.pyexecutablescript2.2 KB
skill-report.jsonconfig39.0 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-09T14:24:28.999Z",
    "slug": "89jobrien-skill-creator",
    "source_url": "https://github.com/89jobrien/steve/tree/main/steve/skills/skill-creator",
    "source_ref": "main",
    "model": "codex",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "3cd1d47c68a634deae77cc20fb58ac82461aaa9616395137685d7717b187a828",
    "tree_hash": "a5b8d80b6b7bc576f654177250f3c2382e3de769045f5ae5d5a4d5ef4d21c4fe",
    "provenance": {
      "model_requested": "gpt-5.5:high",
      "model_effective": "codex:gpt-5.5:high",
      "fallback_chain": [
        {
          "agent": "codex",
          "model": "gpt-5.5",
          "effort": "high",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    }
  },
  "skill": {
    "name": "skill-creator",
    "description": "Guides agents through designing, creating, validating, and packaging AI skills with reusable workflows, references, scripts, and assets.",
    "summary": "Create and improve AI skills with structured workflows, templates, validation scripts, and packaging guidance.",
    "icon": "📦",
    "version": "1.0.1",
    "author": "Joseph OBrien",
    "license": "Complete terms in LICENSE.txt",
    "tags": [
      "skill-creation",
      "agent-workflows",
      "templates",
      "validation",
      "packaging"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "external_commands",
      "filesystem"
    ],
    "category": "documentation"
  },
  "security_audit": {
    "risk_level": "safe",
    "is_blocked": false,
    "safe_to_publish": true,
    "analysis_status": "ok",
    "summary": "All 37 static detections were false positives after context review. The external-command alerts came from Markdown examples, template text, and inline file paths, not executable shell calls. The archive-library detections support explicit zip packaging, and no prompt injection or exfiltration intent was found.",
    "remediation": [],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "scripts/init-skill.py",
            "line_start": 72,
            "line_end": 72
          },
          {
            "file": "scripts/init-skill.py",
            "line_start": 73,
            "line_end": 73
          },
          {
            "file": "scripts/init-skill.py",
            "line_start": 83,
            "line_end": 83
          },
          {
            "file": "SKILL.md",
            "line_start": 37,
            "line_end": 48
          },
          {
            "file": "SKILL.md",
            "line_start": 48,
            "line_end": 52
          },
          {
            "file": "SKILL.md",
            "line_start": 52,
            "line_end": 52
          },
          {
            "file": "SKILL.md",
            "line_start": 56,
            "line_end": 61
          },
          {
            "file": "SKILL.md",
            "line_start": 61,
            "line_end": 65
          },
          {
            "file": "SKILL.md",
            "line_start": 65,
            "line_end": 70
          },
          {
            "file": "SKILL.md",
            "line_start": 70,
            "line_end": 70
          },
          {
            "file": "SKILL.md",
            "line_start": 76,
            "line_end": 81
          },
          {
            "file": "SKILL.md",
            "line_start": 81,
            "line_end": 81
          },
          {
            "file": "SKILL.md",
            "line_start": 123,
            "line_end": 126
          },
          {
            "file": "SKILL.md",
            "line_start": 126,
            "line_end": 128
          },
          {
            "file": "SKILL.md",
            "line_start": 128,
            "line_end": 131
          },
          {
            "file": "SKILL.md",
            "line_start": 131,
            "line_end": 133
          },
          {
            "file": "SKILL.md",
            "line_start": 133,
            "line_end": 136
          },
          {
            "file": "SKILL.md",
            "line_start": 136,
            "line_end": 146
          },
          {
            "file": "SKILL.md",
            "line_start": 146,
            "line_end": 150
          },
          {
            "file": "SKILL.md",
            "line_start": 150,
            "line_end": 152
          },
          {
            "file": "SKILL.md",
            "line_start": 152,
            "line_end": 158
          },
          {
            "file": "SKILL.md",
            "line_start": 158,
            "line_end": 158
          },
          {
            "file": "SKILL.md",
            "line_start": 169,
            "line_end": 169
          },
          {
            "file": "SKILL.md",
            "line_start": 171,
            "line_end": 171
          },
          {
            "file": "SKILL.md",
            "line_start": 187,
            "line_end": 189
          },
          {
            "file": "SKILL.md",
            "line_start": 189,
            "line_end": 193
          },
          {
            "file": "SKILL.md",
            "line_start": 193,
            "line_end": 195
          },
          {
            "file": "SKILL.md",
            "line_start": 195,
            "line_end": 205
          },
          {
            "file": "SKILL.md",
            "line_start": 205,
            "line_end": 211
          },
          {
            "file": "SKILL.md",
            "line_start": 211,
            "line_end": 212
          }
        ]
      },
      {
        "factor": "filesystem",
        "evidence": [
          {
            "file": "scripts/package-skill.py",
            "line_start": 13,
            "line_end": 13
          },
          {
            "file": "scripts/package-skill.py",
            "line_start": 67,
            "line_end": 67
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "blocker:references/agent-skill.template.md:129:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/agent-skill.template.md",
        "line_start": 129,
        "line_end": 129,
        "snippet": "- [ ] Anti-patterns help avoid common mistakes"
      },
      {
        "id": "external_commands:scripts/init-skill.py:72:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "scripts/init-skill.py",
        "line_start": 72,
        "line_end": 72,
        "snippet": "- PDF skill: `fill_fillable_fields.py`, `extract_form_field_info.py` - utilities for PDF manipulatio"
      },
      {
        "id": "external_commands:scripts/init-skill.py:73:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "scripts/init-skill.py",
        "line_start": 73,
        "line_end": 73,
        "snippet": "- DOCX skill: `document.py`, `utilities.py` - Python modules for document processing"
      },
      {
        "id": "external_commands:scripts/init-skill.py:83:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "scripts/init-skill.py",
        "line_start": 83,
        "line_end": 83,
        "snippet": "- Product management: `communication.md`, `context_building.md` - detailed workflow guides"
      },
      {
        "id": "filesystem:scripts/package-skill.py:13:python-archive-libraries",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Python archive libraries",
        "file": "scripts/package-skill.py",
        "line_start": 13,
        "line_end": 13,
        "snippet": "import zipfile"
      },
      {
        "id": "filesystem:scripts/package-skill.py:67:python-archive-libraries",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Python archive libraries",
        "file": "scripts/package-skill.py",
        "line_start": 67,
        "line_end": 67,
        "snippet": "with zipfile.ZipFile(zip_filename, \"w\", zipfile.ZIP_DEFLATED) as zipf:"
      },
      {
        "id": "blocker:scripts/quick-validate.py:26:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "scripts/quick-validate.py",
        "line_start": 26,
        "line_end": 26,
        "snippet": "return False, \"Invalid frontmatter format\""
      },
      {
        "id": "blocker:scripts/quick-validate.py:70:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "scripts/quick-validate.py",
        "line_start": 70,
        "line_end": 70,
        "snippet": "sys.exit(0 if valid else 1)"
      },
      {
        "id": "external_commands:SKILL.md:37:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 37,
        "line_end": 48,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:48:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 48,
        "line_end": 52,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:52:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 52,
        "line_end": 52,
        "snippet": "**Metadata Quality:** The `name` and `description` in YAML frontmatter determine when Claude will us"
      },
      {
        "id": "external_commands:SKILL.md:56:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 56,
        "line_end": 61,
        "snippet": "##### Scripts (`scripts/`)"
      },
      {
        "id": "external_commands:SKILL.md:61:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 61,
        "line_end": 65,
        "snippet": "- **Example**: `scripts/rotate_pdf.py` for PDF rotation tasks"
      },
      {
        "id": "external_commands:SKILL.md:65:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 65,
        "line_end": 70,
        "snippet": "##### References (`references/`)"
      },
      {
        "id": "external_commands:SKILL.md:70:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 70,
        "line_end": 70,
        "snippet": "- **Examples**: `references/finance.md` for financial schemas, `references/mnda.md` for company NDA "
      },
      {
        "id": "external_commands:SKILL.md:76:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 76,
        "line_end": 81,
        "snippet": "##### Assets (`assets/`)"
      },
      {
        "id": "external_commands:SKILL.md:81:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 81,
        "line_end": 81,
        "snippet": "- **Examples**: `assets/logo.png` for brand assets, `assets/slides.pptx` for PowerPoint templates, `"
      },
      {
        "id": "external_commands:SKILL.md:123:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 123,
        "line_end": 126,
        "snippet": "Example: When building a `pdf-editor` skill to handle queries like \"Help me rotate this PDF,\" the an"
      },
      {
        "id": "external_commands:SKILL.md:126:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 126,
        "line_end": 128,
        "snippet": "2. A `scripts/rotate_pdf.py` script would be helpful to store in the skill"
      },
      {
        "id": "external_commands:SKILL.md:128:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 128,
        "line_end": 131,
        "snippet": "Example: When designing a `frontend-webapp-builder` skill for queries like \"Build me a todo app\" or "
      },
      {
        "id": "external_commands:SKILL.md:131:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 131,
        "line_end": 133,
        "snippet": "2. An `assets/hello-world/` template containing the boilerplate HTML/React project files would be he"
      },
      {
        "id": "external_commands:SKILL.md:133:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 133,
        "line_end": 136,
        "snippet": "Example: When building a `big-query` skill to handle queries like \"How many users have logged in tod"
      },
      {
        "id": "external_commands:SKILL.md:136:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 136,
        "line_end": 146,
        "snippet": "2. A `references/schema.md` file documenting the table schemas would be helpful to store in the skil"
      },
      {
        "id": "external_commands:SKILL.md:146:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 146,
        "line_end": 150,
        "snippet": "When creating a new skill from scratch, always run the `init_skill.py` script. The script convenient"
      },
      {
        "id": "external_commands:SKILL.md:150:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 150,
        "line_end": 152,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:152:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 152,
        "line_end": 158,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:158:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 158,
        "line_end": 158,
        "snippet": "- Creates example resource directories: `scripts/`, `references/`, and `assets/`"
      },
      {
        "id": "external_commands:SKILL.md:169:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 169,
        "line_end": 169,
        "snippet": "To begin implementation, start with the reusable resources identified above: `scripts/`, `references"
      },
      {
        "id": "external_commands:SKILL.md:171:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 171,
        "line_end": 171,
        "snippet": "Also, delete any example files and directories not needed for the skill. The initialization script c"
      },
      {
        "id": "external_commands:SKILL.md:187:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 187,
        "line_end": 189,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:189:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 189,
        "line_end": 193,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:193:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 193,
        "line_end": 195,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:195:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 195,
        "line_end": 205,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:205:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 205,
        "line_end": 211,
        "snippet": "2. **Package** the skill if validation passes, creating a zip file named after the skill (e.g., `my-"
      },
      {
        "id": "external_commands:SKILL.md:211:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 211,
        "line_end": 212,
        "snippet": "- **`references/AGENT_SKILL.template.md`** - Skill YAML frontmatter and body structure template"
      },
      {
        "id": "blocker:SKILL.md:74:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 74,
        "line_end": 74,
        "snippet": "- **Avoid duplication**: Information should live in either SKILL.md or references files, not both. P"
      },
      {
        "id": "blocker:SKILL.md:112:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 112,
        "line_end": 112,
        "snippet": "To avoid overwhelming users, avoid asking too many questions in a single message. Start with the mos"
      }
    ],
    "finding_verdicts": [
      {
        "id": "blocker:references/agent-skill.template.md:129:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "Line 129 is a template checklist item about documenting anti-patterns. It does not gather system information or block analysis."
      },
      {
        "id": "external_commands:scripts/init-skill.py:72:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The flagged backticks are inside a Python template string that documents example file names. There is no shell execution API or subprocess call."
      },
      {
        "id": "external_commands:scripts/init-skill.py:73:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The flagged backticks are inside a Python template string that documents example file names. There is no shell execution API or subprocess call."
      },
      {
        "id": "external_commands:scripts/init-skill.py:83:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The flagged backticks are inside a Python template string that documents example file names. There is no shell execution API or subprocess call."
      },
      {
        "id": "filesystem:scripts/package-skill.py:13:python-archive-libraries",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The zipfile import supports the intended packaging utility. Importing the archive library alone does not extract archives or hide filesystem access."
      },
      {
        "id": "filesystem:scripts/package-skill.py:67:python-archive-libraries",
        "verdict": "false_positive",
        "confidence": 0.89,
        "reason": "The ZipFile call creates a user-requested distributable archive after validation. It writes the package explicitly and does not perform unsafe extraction."
      },
      {
        "id": "blocker:scripts/quick-validate.py:26:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "Line 26 returns a validation error string for malformed frontmatter. It does not inspect host configuration or collect system data."
      },
      {
        "id": "blocker:scripts/quick-validate.py:70:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "Line 70 exits with the validator result code. This is ordinary CLI control flow, not reconnaissance."
      },
      {
        "id": "external_commands:SKILL.md:37:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "external_commands:SKILL.md:48:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "external_commands:SKILL.md:52:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "external_commands:SKILL.md:56:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "external_commands:SKILL.md:61:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "external_commands:SKILL.md:65:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "external_commands:SKILL.md:70:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "external_commands:SKILL.md:76:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "external_commands:SKILL.md:81:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "external_commands:SKILL.md:123:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "external_commands:SKILL.md:126:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "external_commands:SKILL.md:128:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "external_commands:SKILL.md:131:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "external_commands:SKILL.md:133:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "external_commands:SKILL.md:136:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "external_commands:SKILL.md:146:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "external_commands:SKILL.md:150:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "external_commands:SKILL.md:152:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "external_commands:SKILL.md:158:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "external_commands:SKILL.md:169:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "external_commands:SKILL.md:171:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "external_commands:SKILL.md:187:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "external_commands:SKILL.md:189:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "external_commands:SKILL.md:193:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "external_commands:SKILL.md:195:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "external_commands:SKILL.md:205:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "external_commands:SKILL.md:211:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The match is Markdown documentation with inline paths, fenced examples, or command examples. SKILL.md contains no executable code path for shell execution."
      },
      {
        "id": "blocker:SKILL.md:74:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "Line 74 advises authors to move large content into references. It is documentation structure guidance, not system reconnaissance."
      },
      {
        "id": "blocker:SKILL.md:112:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "Line 112 gives conversation guidance about limiting questions. It does not probe the runtime environment or block security review."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 7,
    "total_lines": 1130,
    "audit_model": "codex",
    "audited_at": "2026-07-09T14:24:28.999Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Create Effective AI Skills",
    "value_statement": "Building reusable AI skills is hard when structure, resources, and validation rules are unclear. This skill provides a practical workflow for designing, writing, validating, and packaging skills.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "AI skill creator",
      "skill development",
      "agent skill templates",
      "skill validation",
      "skill packaging",
      "progressive disclosure",
      "workflow design"
    ],
    "actual_capabilities": [
      "Explains the required SKILL.md structure and optional resource folders.",
      "Guides planning from concrete user examples before writing instructions.",
      "Provides templates for skill and subagent documentation.",
      "Includes scripts to initialize, validate, and package skill folders.",
      "Recommends progressive disclosure for large references and resources.",
      "Gives quality checks for metadata, examples, and reusable assets."
    ],
    "limitations": [
      "It does not create domain expertise without user-provided requirements.",
      "Generated skills still need human review before publication.",
      "The validator checks structure, not full behavioral quality.",
      "Some command examples may need path updates to match bundled script names."
    ],
    "use_cases": [
      {
        "title": "Create a New Workflow Skill",
        "description": "Design a skill that captures a repeatable business or technical workflow for future agent use.",
        "target_user": "Operations teams"
      },
      {
        "title": "Improve Existing Skill Quality",
        "description": "Review a draft skill for unclear triggers, missing resources, placeholder text, and weak examples.",
        "target_user": "AI enablement leads"
      },
      {
        "title": "Package Skills for Sharing",
        "description": "Validate a completed skill folder and create a distributable archive for review or installation.",
        "target_user": "Developer tool maintainers"
      }
    ],
    "prompt_templates": [
      {
        "title": "Create a Basic Skill",
        "scenario": "Beginner skill design",
        "prompt": "Use the skill creator to design a simple skill for [task]. Ask for missing goals, then draft the structure."
      },
      {
        "title": "Improve a Draft Skill",
        "scenario": "Intermediate revision",
        "prompt": "Review my existing skill folder. Identify unclear triggers, missing reusable resources, placeholder text, and validation issues."
      },
      {
        "title": "Plan Reusable Resources",
        "scenario": "Advanced architecture",
        "prompt": "Given these user examples, decide which scripts, references, and assets should be bundled with the skill."
      },
      {
        "title": "Prepare a Skill Release",
        "scenario": "Advanced publication workflow",
        "prompt": "Validate this skill for release. Check metadata, file organization, examples, resource references, and packaging readiness."
      }
    ],
    "output_examples": [
      {
        "input": "Create a skill for handling monthly finance reporting.",
        "output": [
          "A short trigger description for finance reporting tasks.",
          "A workflow outline covering inputs, validation, report creation, and review.",
          "Suggested references for chart of accounts, report rules, and examples."
        ]
      },
      {
        "input": "Review my draft customer-support skill before I publish it.",
        "output": [
          "A list of unclear trigger conditions and missing concrete examples.",
          "Recommendations for moving long policy details into reference files.",
          "Validation and packaging steps to run after revisions."
        ]
      },
      {
        "input": "Package a completed skill folder for sharing.",
        "output": "A validation-first packaging checklist, with expected archive output and errors to fix before distribution."
      }
    ],
    "best_practices": [
      "Start from concrete user requests before choosing the skill structure.",
      "Keep SKILL.md focused and move long details into references.",
      "Run validation before packaging or sharing a skill."
    ],
    "anti_patterns": [
      "Do not leave TODO placeholders in published skill files.",
      "Do not add scripts or assets that the workflow never uses.",
      "Do not hide trigger guidance only inside the skill body."
    ],
    "faq": [
      {
        "question": "What does this skill help me create?",
        "answer": "It helps create AI skills with clear triggers, reusable resources, validation checks, and packaging steps."
      },
      {
        "question": "Can it update an existing skill?",
        "answer": "Yes. It can guide review, restructuring, resource planning, validation, and packaging for an existing skill."
      },
      {
        "question": "Does it write all domain content for me?",
        "answer": "No. It needs concrete examples, requirements, or source material to create useful domain-specific instructions."
      },
      {
        "question": "What files does it expect?",
        "answer": "A skill needs SKILL.md. Optional scripts, references, and assets are used when they support repeatable work."
      },
      {
        "question": "Does it include validation tools?",
        "answer": "Yes. The bundled validator checks basic frontmatter, naming rules, and skill folder requirements."
      },
      {
        "question": "Is it suitable for marketplace publication?",
        "answer": "It can prepare skills for review, but authors should still verify quality, safety, and licensing before publication."
      }
    ]
  },
  "file_structure": [
    {
      "name": "references",
      "type": "dir",
      "path": "references",
      "children": [
        {
          "name": "agent-skill.template.md",
          "type": "file",
          "path": "references/agent-skill.template.md",
          "lines": 132
        },
        {
          "name": "SUBAGENT.template.md",
          "type": "file",
          "path": "references/SUBAGENT.template.md",
          "lines": 91
        }
      ]
    },
    {
      "name": "scripts",
      "type": "dir",
      "path": "scripts",
      "children": [
        {
          "name": "init-skill.py",
          "type": "file",
          "path": "scripts/init-skill.py",
          "lines": 299
        },
        {
          "name": "package-skill.py",
          "type": "file",
          "path": "scripts/package-skill.py",
          "lines": 110
        },
        {
          "name": "quick-validate.py",
          "type": "file",
          "path": "scripts/quick-validate.py",
          "lines": 71
        }
      ]
    },
    {
      "name": "LICENSE.txt",
      "type": "file",
      "path": "LICENSE.txt",
      "lines": 203
    },
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 224
    }
  ]
}
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: 472kUpdated 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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated 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: 322kUpdated Claude CodeCodexVerifiedInstall