Skip to content

aiskillstore/marketplace / skills/7spade/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 md17.4 KB
references/output-patterns.mdmarkdown1.8 KB
references/workflows.mdmarkdown818 B
scripts/init_skill.pyscript10.6 KB
scripts/package_skill.pyscript3.2 KB
scripts/quick_validate.pyscript3.4 KB
skill-report.jsonconfig48.0 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-04T17:39:43.576Z",
    "slug": "7spade-skill-creator",
    "source_url": "https://github.com/7Spade/ng-dragon/tree/main/.github/skills/skill-creator",
    "source_ref": "main",
    "model": "codex",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "79affa03d7b1c159bc2e72cd96b06b34ee78fc9ca18f69ea33dc6cec0ea604a3",
    "tree_hash": "e4a859b45ed372262b95319cf732aa6860645ba4f6b934167e92c7a1f3a6ede1",
    "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": "Guide for creating or updating AI skills with structured instructions, reusable resources, validation, and packaging support.",
    "summary": "Guides AI agents through planning, creating, validating, and packaging reusable skills.",
    "icon": "📦",
    "version": "1.0.0",
    "author": "7Spade",
    "license": "Complete terms in LICENSE.txt",
    "tags": [
      "skill-authoring",
      "ai-agents",
      "workflow-design",
      "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 50 static findings were adjudicated as false positives after reviewing the cited files. The alerts come from markdown backticks, archive packaging used for .skill creation, dictionary key validation, and normal validator exits. No prompt injection, credential access, network exfiltration, or malicious intent was found.",
    "remediation": [],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "scripts/init_skill.py",
            "line_start": 73,
            "line_end": 73
          },
          {
            "file": "scripts/init_skill.py",
            "line_start": 74,
            "line_end": 74
          },
          {
            "file": "scripts/init_skill.py",
            "line_start": 84,
            "line_end": 84
          },
          {
            "file": "SKILL.md",
            "line_start": 51,
            "line_end": 62
          },
          {
            "file": "SKILL.md",
            "line_start": 62,
            "line_end": 68
          },
          {
            "file": "SKILL.md",
            "line_start": 68,
            "line_end": 68
          },
          {
            "file": "SKILL.md",
            "line_start": 73,
            "line_end": 78
          },
          {
            "file": "SKILL.md",
            "line_start": 78,
            "line_end": 82
          },
          {
            "file": "SKILL.md",
            "line_start": 82,
            "line_end": 87
          },
          {
            "file": "SKILL.md",
            "line_start": 87,
            "line_end": 87
          },
          {
            "file": "SKILL.md",
            "line_start": 93,
            "line_end": 98
          },
          {
            "file": "SKILL.md",
            "line_start": 98,
            "line_end": 98
          },
          {
            "file": "SKILL.md",
            "line_start": 130,
            "line_end": 143
          },
          {
            "file": "SKILL.md",
            "line_start": 143,
            "line_end": 151
          },
          {
            "file": "SKILL.md",
            "line_start": 151,
            "line_end": 159
          },
          {
            "file": "SKILL.md",
            "line_start": 159,
            "line_end": 165
          },
          {
            "file": "SKILL.md",
            "line_start": 165,
            "line_end": 172
          },
          {
            "file": "SKILL.md",
            "line_start": 172,
            "line_end": 180
          },
          {
            "file": "SKILL.md",
            "line_start": 180,
            "line_end": 193
          },
          {
            "file": "SKILL.md",
            "line_start": 193,
            "line_end": 239
          },
          {
            "file": "SKILL.md",
            "line_start": 239,
            "line_end": 242
          },
          {
            "file": "SKILL.md",
            "line_start": 242,
            "line_end": 244
          },
          {
            "file": "SKILL.md",
            "line_start": 244,
            "line_end": 247
          },
          {
            "file": "SKILL.md",
            "line_start": 247,
            "line_end": 249
          },
          {
            "file": "SKILL.md",
            "line_start": 249,
            "line_end": 252
          },
          {
            "file": "SKILL.md",
            "line_start": 252,
            "line_end": 262
          },
          {
            "file": "SKILL.md",
            "line_start": 262,
            "line_end": 266
          },
          {
            "file": "SKILL.md",
            "line_start": 266,
            "line_end": 268
          },
          {
            "file": "SKILL.md",
            "line_start": 268,
            "line_end": 274
          },
          {
            "file": "SKILL.md",
            "line_start": 274,
            "line_end": 274
          },
          {
            "file": "SKILL.md",
            "line_start": 294,
            "line_end": 294
          },
          {
            "file": "SKILL.md",
            "line_start": 298,
            "line_end": 298
          },
          {
            "file": "SKILL.md",
            "line_start": 306,
            "line_end": 306
          },
          {
            "file": "SKILL.md",
            "line_start": 308,
            "line_end": 309
          },
          {
            "file": "SKILL.md",
            "line_start": 309,
            "line_end": 312
          },
          {
            "file": "SKILL.md",
            "line_start": 312,
            "line_end": 324
          },
          {
            "file": "SKILL.md",
            "line_start": 324,
            "line_end": 326
          },
          {
            "file": "SKILL.md",
            "line_start": 326,
            "line_end": 330
          },
          {
            "file": "SKILL.md",
            "line_start": 330,
            "line_end": 332
          },
          {
            "file": "SKILL.md",
            "line_start": 332,
            "line_end": 343
          }
        ]
      },
      {
        "factor": "filesystem",
        "evidence": [
          {
            "file": "scripts/package_skill.py",
            "line_start": 14,
            "line_end": 14
          },
          {
            "file": "scripts/package_skill.py",
            "line_start": 68,
            "line_end": 68
          }
        ]
      }
    ],
    "static_findings": [
      {
        "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": "- PDF skill: `fill_fillable_fields.py`, `extract_form_field_info.py` - utilities for PDF manipulatio"
      },
      {
        "id": "external_commands:scripts/init_skill.py:74:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "scripts/init_skill.py",
        "line_start": 74,
        "line_end": 74,
        "snippet": "- DOCX skill: `document.py`, `utilities.py` - Python modules for document processing"
      },
      {
        "id": "external_commands:scripts/init_skill.py:84:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "scripts/init_skill.py",
        "line_start": 84,
        "line_end": 84,
        "snippet": "- Product management: `communication.md`, `context_building.md` - detailed workflow guides"
      },
      {
        "id": "filesystem:scripts/package_skill.py:14:python-archive-libraries",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Python archive libraries",
        "file": "scripts/package_skill.py",
        "line_start": 14,
        "line_end": 14,
        "snippet": "import zipfile"
      },
      {
        "id": "filesystem:scripts/package_skill.py:68:python-archive-libraries",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Python archive libraries",
        "file": "scripts/package_skill.py",
        "line_start": 68,
        "line_end": 68,
        "snippet": "with zipfile.ZipFile(skill_filename, 'w', zipfile.ZIP_DEFLATED) as zipf:"
      },
      {
        "id": "sensitive:scripts/quick_validate.py:45:certificate-key-files",
        "category": "sensitive",
        "severity": "high",
        "pattern": "Certificate/key files",
        "file": "scripts/quick_validate.py",
        "line_start": 45,
        "line_end": 45,
        "snippet": "unexpected_keys = set(frontmatter.keys()) - ALLOWED_PROPERTIES"
      },
      {
        "id": "blocker:scripts/quick_validate.py:29:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "scripts/quick_validate.py",
        "line_start": 29,
        "line_end": 29,
        "snippet": "return False, \"Invalid frontmatter format\""
      },
      {
        "id": "blocker:scripts/quick_validate.py:39:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "scripts/quick_validate.py",
        "line_start": 39,
        "line_end": 39,
        "snippet": "return False, f\"Invalid YAML in frontmatter: {e}\""
      },
      {
        "id": "blocker:scripts/quick_validate.py:95:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "scripts/quick_validate.py",
        "line_start": 95,
        "line_end": 95,
        "snippet": "sys.exit(0 if valid else 1)"
      },
      {
        "id": "external_commands:SKILL.md:51:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 51,
        "line_end": 62,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:62:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 62,
        "line_end": 68,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 68,
        "line_end": 68,
        "snippet": "- **Frontmatter** (YAML): Contains `name` and `description` fields. These are the only fields that C"
      },
      {
        "id": "external_commands:SKILL.md:73:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 73,
        "line_end": 78,
        "snippet": "##### Scripts (`scripts/`)"
      },
      {
        "id": "external_commands:SKILL.md:78:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 78,
        "line_end": 82,
        "snippet": "- **Example**: `scripts/rotate_pdf.py` for PDF rotation tasks"
      },
      {
        "id": "external_commands:SKILL.md:82:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 82,
        "line_end": 87,
        "snippet": "##### References (`references/`)"
      },
      {
        "id": "external_commands:SKILL.md:87:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 87,
        "line_end": 87,
        "snippet": "- **Examples**: `references/finance.md` for financial schemas, `references/mnda.md` for company NDA "
      },
      {
        "id": "external_commands:SKILL.md:93:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 93,
        "line_end": 98,
        "snippet": "##### Assets (`assets/`)"
      },
      {
        "id": "external_commands:SKILL.md:98:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 98,
        "line_end": 98,
        "snippet": "- **Examples**: `assets/logo.png` for brand assets, `assets/slides.pptx` for PowerPoint templates, `"
      },
      {
        "id": "external_commands:SKILL.md:130:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 130,
        "line_end": 143,
        "snippet": "```markdown"
      },
      {
        "id": "external_commands:SKILL.md:143:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 143,
        "line_end": 151,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:151:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 151,
        "line_end": 159,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:159:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 159,
        "line_end": 165,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:165:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 165,
        "line_end": 172,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:172:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 172,
        "line_end": 180,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:180:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 180,
        "line_end": 193,
        "snippet": "```markdown"
      },
      {
        "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": 239,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:239:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 239,
        "line_end": 242,
        "snippet": "Example: When building a `pdf-editor` skill to handle queries like \"Help me rotate this PDF,\" the an"
      },
      {
        "id": "external_commands:SKILL.md:242:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 242,
        "line_end": 244,
        "snippet": "2. A `scripts/rotate_pdf.py` script would be helpful to store in the skill"
      },
      {
        "id": "external_commands:SKILL.md:244:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 244,
        "line_end": 247,
        "snippet": "Example: When designing a `frontend-webapp-builder` skill for queries like \"Build me a todo app\" or "
      },
      {
        "id": "external_commands:SKILL.md:247:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 247,
        "line_end": 249,
        "snippet": "2. An `assets/hello-world/` template containing the boilerplate HTML/React project files would be he"
      },
      {
        "id": "external_commands:SKILL.md:249:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 249,
        "line_end": 252,
        "snippet": "Example: When building a `big-query` skill to handle queries like \"How many users have logged in tod"
      },
      {
        "id": "external_commands:SKILL.md:252:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 252,
        "line_end": 262,
        "snippet": "2. A `references/schema.md` file documenting the table schemas would be helpful to store in the skil"
      },
      {
        "id": "external_commands:SKILL.md:262:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 262,
        "line_end": 266,
        "snippet": "When creating a new skill from scratch, always run the `init_skill.py` script. The script convenient"
      },
      {
        "id": "external_commands:SKILL.md:266:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 266,
        "line_end": 268,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:268:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 268,
        "line_end": 274,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:274:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 274,
        "line_end": 274,
        "snippet": "- Creates example resource directories: `scripts/`, `references/`, and `assets/`"
      },
      {
        "id": "external_commands:SKILL.md:294:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 294,
        "line_end": 294,
        "snippet": "To begin implementation, start with the reusable resources identified above: `scripts/`, `references"
      },
      {
        "id": "external_commands:SKILL.md:298:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 298,
        "line_end": 298,
        "snippet": "Any example files and directories not needed for the skill should be deleted. The initialization scr"
      },
      {
        "id": "external_commands:SKILL.md:306:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 306,
        "line_end": 306,
        "snippet": "Write the YAML frontmatter with `name` and `description`:"
      },
      {
        "id": "external_commands:SKILL.md:308:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 308,
        "line_end": 309,
        "snippet": "- `name`: The skill name"
      },
      {
        "id": "external_commands:SKILL.md:309:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 309,
        "line_end": 312,
        "snippet": "- `description`: This is the primary triggering mechanism for your skill, and helps Claude understan"
      },
      {
        "id": "external_commands:SKILL.md:312:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 312,
        "line_end": 324,
        "snippet": "- Example description for a `docx` skill: \"Comprehensive document creation, editing, and analysis wi"
      },
      {
        "id": "external_commands:SKILL.md:324:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 324,
        "line_end": 326,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:326:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 326,
        "line_end": 330,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:330:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 330,
        "line_end": 332,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:332:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 332,
        "line_end": 343,
        "snippet": "```"
      },
      {
        "id": "blocker:SKILL.md:91:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 91,
        "line_end": 91,
        "snippet": "- **Avoid duplication**: Information should live in either SKILL.md or references files, not both. P"
      },
      {
        "id": "blocker:SKILL.md:149:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 149,
        "line_end": 149,
        "snippet": "For Skills with multiple domains, organize content by domain to avoid loading irrelevant context:"
      },
      {
        "id": "blocker:SKILL.md:199:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 199,
        "line_end": 199,
        "snippet": "- **Avoid deeply nested references** - Keep references one level deep from SKILL.md. All reference f"
      },
      {
        "id": "blocker:SKILL.md:228:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 228,
        "line_end": 228,
        "snippet": "To avoid overwhelming users, avoid asking too many questions in a single message. Start with the mos"
      }
    ],
    "finding_verdicts": [
      {
        "id": "external_commands:scripts/init_skill.py:73:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is inside a Python template string that generates markdown examples. It uses inline backticks for file names, not shell execution."
      },
      {
        "id": "external_commands:scripts/init_skill.py:74:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is inside a Python template string that generates markdown examples. It uses inline backticks for file names, not shell execution."
      },
      {
        "id": "external_commands:scripts/init_skill.py:84:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is inside a Python template string that generates markdown examples. It uses inline backticks for file names, not shell execution."
      },
      {
        "id": "filesystem:scripts/package_skill.py:14:python-archive-libraries",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The zipfile import supports the documented skill packaging workflow. Importing the archive library alone does not execute code or access data."
      },
      {
        "id": "filesystem:scripts/package_skill.py:68:python-archive-libraries",
        "verdict": "false_positive",
        "confidence": 0.86,
        "reason": "The script creates a local .skill archive from a user-specified skill folder after validation. It does not extract archives, make network calls, or hide data transfer."
      },
      {
        "id": "sensitive:scripts/quick_validate.py:45:certificate-key-files",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The word keys refers to YAML frontmatter dictionary keys. The code does not read certificates, private keys, or other credential files."
      },
      {
        "id": "blocker:scripts/quick_validate.py:29:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "This validation script returns error messages and exits with a status code. It does not collect host details or perform system reconnaissance."
      },
      {
        "id": "blocker:scripts/quick_validate.py:39:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "This validation script returns error messages and exits with a status code. It does not collect host details or perform system reconnaissance."
      },
      {
        "id": "blocker:scripts/quick_validate.py:95:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "This validation script returns error messages and exits with a status code. It does not collect host details or perform system reconnaissance."
      },
      {
        "id": "external_commands:SKILL.md:51:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:62:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:73:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:78:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:82:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:87:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:93:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:98:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:130:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:143:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:151:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:159:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:165:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:172:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:180:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:193:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:239:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:242:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:244:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:247:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:249:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:252:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:262:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:266:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:268:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:274:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:294:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:298:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:306:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:308:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:309:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:312:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:324:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:326:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:330:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:332:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "SKILL.md uses markdown backticks for code fences, paths, and example commands. The text is documentation and contains no executable shell interpolation."
      },
      {
        "id": "blocker:SKILL.md:91:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged SKILL.md text is skill design guidance about concise references and user questions. It does not request host probing or sensitive system discovery."
      },
      {
        "id": "blocker:SKILL.md:149:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged SKILL.md text is skill design guidance about concise references and user questions. It does not request host probing or sensitive system discovery."
      },
      {
        "id": "blocker:SKILL.md:199:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged SKILL.md text is skill design guidance about concise references and user questions. It does not request host probing or sensitive system discovery."
      },
      {
        "id": "blocker:SKILL.md:228:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged SKILL.md text is skill design guidance about concise references and user questions. It does not request host probing or sensitive system discovery."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 7,
    "total_lines": 1180,
    "audit_model": "codex",
    "audited_at": "2026-07-04T17:39:43.576Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Create Reliable AI Skills",
    "value_statement": "AI teams often need reusable workflows but lack a clear skill structure. This skill guides Claude, Codex, and Claude Code through planning, authoring, validating, and packaging skills.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "AI skill creator",
      "skill authoring",
      "agent workflows",
      "skill packaging",
      "prompt templates",
      "workflow documentation",
      "developer automation"
    ],
    "actual_capabilities": [
      "Explains required SKILL.md frontmatter and body structure.",
      "Recommends when to use scripts, references, and assets.",
      "Provides an initializer script that creates a template skill directory.",
      "Provides validation and packaging scripts for .skill files.",
      "Links reference guides for workflow and output design patterns."
    ],
    "limitations": [
      "It does not publish skills to a marketplace.",
      "Generated templates still require human domain content.",
      "Local scripts should be reviewed before use.",
      "Basic validation does not replace a security review."
    ],
    "use_cases": [
      {
        "title": "Create a New Skill",
        "description": "Plan the structure, resources, and trigger description for a new AI skill.",
        "target_user": "AI workflow developer"
      },
      {
        "title": "Standardize Team Guidance",
        "description": "Turn repeated team procedures into reusable skill instructions and references.",
        "target_user": "Engineering manager"
      },
      {
        "title": "Package a Finished Skill",
        "description": "Validate a skill folder and create a distributable .skill archive.",
        "target_user": "Tooling maintainer"
      }
    ],
    "prompt_templates": [
      {
        "title": "Start a Basic Skill",
        "scenario": "Beginner planning for a simple workflow.",
        "prompt": "Create a skill for [task]. Ask only the questions needed to define its purpose, trigger, and core workflow."
      },
      {
        "title": "Improve an Existing Skill",
        "scenario": "Refine a draft skill for clarity and usefulness.",
        "prompt": "Review this skill folder and suggest focused changes to improve the description, structure, and bundled resources."
      },
      {
        "title": "Design Reusable Resources",
        "scenario": "Decide which scripts, references, or assets belong in a skill.",
        "prompt": "Analyze these usage examples and recommend the reusable scripts, references, and assets this skill should include."
      },
      {
        "title": "Prepare for Distribution",
        "scenario": "Advanced validation and packaging workflow.",
        "prompt": "Validate this skill, identify packaging blockers, and prepare a concise release checklist for a .skill archive."
      }
    ],
    "output_examples": [
      {
        "input": "Create a skill for recurring PDF rotation tasks.",
        "output": [
          "A trigger description for PDF editing requests.",
          "A lean workflow for choosing rotation actions.",
          "A recommendation to add a tested PDF helper script."
        ]
      },
      {
        "input": "Improve this draft database reporting skill.",
        "output": [
          "A shorter SKILL.md body focused on selection guidance.",
          "A reference file plan for schemas and query examples.",
          "A validation checklist before packaging."
        ]
      }
    ],
    "best_practices": [
      "Keep SKILL.md concise and move detailed material into referenced files.",
      "Use scripts only for repeatable tasks that need reliable execution.",
      "Test bundled scripts before packaging the skill."
    ],
    "anti_patterns": [
      "Do not add broad background information that the model already knows.",
      "Do not hide trigger guidance only inside the skill body.",
      "Do not keep unused example files after initialization."
    ],
    "faq": [
      {
        "question": "What does this skill help create?",
        "answer": "It helps create structured AI skills with instructions, references, scripts, and assets."
      },
      {
        "question": "Does it create every skill file automatically?",
        "answer": "It can initialize a template folder. The author still adds domain knowledge and final content."
      },
      {
        "question": "Can it update an existing skill?",
        "answer": "Yes. It gives guidance for reviewing structure, improving instructions, and packaging updates."
      },
      {
        "question": "Which tools can use the skill?",
        "answer": "The report lists support for Claude, Codex, and Claude Code."
      },
      {
        "question": "Does it include validation?",
        "answer": "Yes. It includes a basic validator for frontmatter and naming checks."
      },
      {
        "question": "Does validation guarantee marketplace approval?",
        "answer": "No. Validation checks structure, but marketplace review may require security and content checks."
      }
    ]
  },
  "file_structure": [
    {
      "name": "references",
      "type": "dir",
      "path": "references",
      "children": [
        {
          "name": "output-patterns.md",
          "type": "file",
          "path": "references/output-patterns.md",
          "lines": 83
        },
        {
          "name": "workflows.md",
          "type": "file",
          "path": "references/workflows.md",
          "lines": 28
        }
      ]
    },
    {
      "name": "scripts",
      "type": "dir",
      "path": "scripts",
      "children": [
        {
          "name": "init_skill.py",
          "type": "file",
          "path": "scripts/init_skill.py",
          "lines": 304
        },
        {
          "name": "package_skill.py",
          "type": "file",
          "path": "scripts/package_skill.py",
          "lines": 111
        },
        {
          "name": "quick_validate.py",
          "type": "file",
          "path": "scripts/quick_validate.py",
          "lines": 95
        }
      ]
    },
    {
      "name": "LICENSE.txt",
      "type": "file",
      "path": "LICENSE.txt",
      "lines": 202
    },
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 357
    }
  ]
}
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