aiskillstore/marketplace / skills/abdullahmalik17/skill-creator
skill-creator
VerifiedGuide 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.
| File | Kind | Size |
|---|---|---|
| LICENSE.txt | markdown | 11.1 KB |
| SKILL.md | skill md | 17.4 KB |
| references/output-patterns.md | markdown | 1.8 KB |
| references/workflows.md | markdown | 818 B |
| scripts/init_skill.py | script | 10.6 KB |
| scripts/package_skill.py | script | 3.2 KB |
| scripts/quick_validate.py | script | 3.4 KB |
| skill-report.json | config | 53.3 KB |
skill-report.json
View on GitHub{
"schema_version": "2.0",
"meta": {
"generated_at": "2026-07-07T18:50:30.903Z",
"slug": "abdullahmalik17-skill-creator",
"source_url": "https://github.com/AbdullahMalik17/Cloud-Native-AI/tree/main/.claude/skills/skill-creator",
"source_ref": "main",
"model": "codex",
"analysis_version": "3.0.0",
"source_type": "community",
"content_hash": "b2e3d83f60425c2d0b9d4162efb8f9aa322b45843497340f2289f42be422801c",
"tree_hash": "685e7d09c777701d0dbb702af87999918a7852f697a9ec0fcf228e02adb57de9",
"provenance": {
"model_effective": "codex",
"fallback_chain": [
{
"agent": "codex",
"outcome": "success"
}
],
"analysis_version": "3.0.0"
}
},
"skill": {
"name": "skill-creator",
"description": "Guide for designing, scaffolding, validating, and packaging AI skills with concise SKILL.md instructions, progressive disclosure, reusable resources, and local helper scripts.",
"summary": "Create effective AI skills with structured guidance, templates, validation, and packaging helpers.",
"icon": "📦",
"version": "1.0.1",
"author": "AbdullahMalik17",
"license": "Complete terms in LICENSE.txt",
"tags": [
"skill-authoring",
"ai-agents",
"templates",
"validation",
"packaging"
],
"supported_tools": [
"claude",
"codex",
"claude-code"
],
"risk_factors": [
"external_commands",
"filesystem"
],
"category": "productivity"
},
"security_audit": {
"risk_level": "medium",
"is_blocked": false,
"safe_to_publish": true,
"analysis_status": "ok",
"summary": "Most static findings are false positives caused by markdown code fences, inline filenames, and the word keys in YAML validation code. The review found no prompt injection or malicious exfiltration intent, but the helper scripts have local filesystem risks around unvalidated skill names and broad archive inclusion.",
"remediation": [
{
"issue": "Unvalidated skill names can escape the selected output directory.",
"suggestion": "Validate skill_name against the documented hyphen-case rule, reject path separators and '..', and ensure the resolved output stays under the selected directory before writing files.",
"severity": "medium"
},
{
"issue": "Skill archives may include unintended local files.",
"suggestion": "Add an allowlist or exclusion list for __pycache__, hidden files, virtual environments, archives, and credential-like filenames before writing the .skill file.",
"severity": "medium"
}
],
"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.95,
"reason": "The flagged text is inside a Python template string that documents example filenames. It is not shell execution and does not build or run a command."
},
{
"id": "external_commands:scripts/init_skill.py:74:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The flagged text is inside a Python template string that documents example filenames. It is not shell execution and does not build or run a command."
},
{
"id": "external_commands:scripts/init_skill.py:84:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The flagged text is inside a Python template string that documents example filenames. It is not shell execution and does not build or run a command."
},
{
"id": "filesystem:scripts/package_skill.py:14:python-archive-libraries",
"verdict": "false_positive",
"confidence": 0.82,
"reason": "zipfile is used to create the declared .skill archive after local validation. The archive behavior has a filtering weakness captured separately, but this import or call is not malicious by itself."
},
{
"id": "filesystem:scripts/package_skill.py:68:python-archive-libraries",
"verdict": "false_positive",
"confidence": 0.82,
"reason": "zipfile is used to create the declared .skill archive after local validation. The archive behavior has a filtering weakness captured separately, but this import or call is not malicious by itself."
},
{
"id": "sensitive:scripts/quick_validate.py:45:certificate-key-files",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "The word keys refers to YAML frontmatter dictionary keys. The code does not access certificates, private keys, or secret files."
},
{
"id": "blocker:scripts/quick_validate.py:29:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The line returns a validation error or process exit status. It performs no host enumeration, system discovery, or reconnaissance."
},
{
"id": "blocker:scripts/quick_validate.py:39:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The line returns a validation error or process exit status. It performs no host enumeration, system discovery, or reconnaissance."
},
{
"id": "blocker:scripts/quick_validate.py:95:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The line returns a validation error or process exit status. It performs no host enumeration, system discovery, or reconnaissance."
},
{
"id": "external_commands:SKILL.md:51:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:62:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:73:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:78:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:82:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:87:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:93:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:98:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:130:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:143:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:151:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:159:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:165:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:172:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:180:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:193:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:239:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:242:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:244:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:247:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:249:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:252:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:262:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.88,
"reason": "This section documents how a user may run visible local helper scripts. SKILL.md does not execute commands automatically or construct an untrusted shell string."
},
{
"id": "external_commands:SKILL.md:266:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.88,
"reason": "This section documents how a user may run visible local helper scripts. SKILL.md does not execute commands automatically or construct an untrusted shell string."
},
{
"id": "external_commands:SKILL.md:268:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.88,
"reason": "This section documents how a user may run visible local helper scripts. SKILL.md does not execute commands automatically or construct an untrusted shell string."
},
{
"id": "external_commands:SKILL.md:274:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:294:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:298:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:306:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:308:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:309:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:312:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The flagged content is markdown formatting, a fenced example, or an inline filename. It is instructional text, not executable backtick shell syntax."
},
{
"id": "external_commands:SKILL.md:324:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.88,
"reason": "This section documents how a user may run visible local helper scripts. SKILL.md does not execute commands automatically or construct an untrusted shell string."
},
{
"id": "external_commands:SKILL.md:326:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.88,
"reason": "This section documents how a user may run visible local helper scripts. SKILL.md does not execute commands automatically or construct an untrusted shell string."
},
{
"id": "external_commands:SKILL.md:330:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.88,
"reason": "This section documents how a user may run visible local helper scripts. SKILL.md does not execute commands automatically or construct an untrusted shell string."
},
{
"id": "external_commands:SKILL.md:332:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.88,
"reason": "This section documents how a user may run visible local helper scripts. SKILL.md does not execute commands automatically or construct an untrusted shell string."
},
{
"id": "blocker:SKILL.md:91:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The line is skill-design guidance about references, organization, or user questions. It does not request system inventory or environment reconnaissance."
},
{
"id": "blocker:SKILL.md:149:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The line is skill-design guidance about references, organization, or user questions. It does not request system inventory or environment reconnaissance."
},
{
"id": "blocker:SKILL.md:199:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The line is skill-design guidance about references, organization, or user questions. It does not request system inventory or environment reconnaissance."
},
{
"id": "blocker:SKILL.md:228:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The line is skill-design guidance about references, organization, or user questions. It does not request system inventory or environment reconnaissance."
}
],
"semantic_findings": [
{
"title": "Unvalidated Skill Name Controls Output Path",
"description": "scripts/init_skill.py combines the user-supplied output path with skill_name before creating directories and files. A name containing path separators or parent directory segments could write generated files outside the intended output folder.",
"severity": "medium",
"locations": [
{
"file": "scripts/init_skill.py",
"line_start": 205,
"line_end": 215
},
{
"file": "scripts/init_skill.py",
"line_start": 287,
"line_end": 294
}
],
"confidence": 0.84,
"confidence_reasoning": "The code joins Path(path).resolve() with raw skill_name and then creates the directory. The CLI text states naming rules, but the script does not enforce them before filesystem writes."
},
{
"title": "Packager Archives All Files Under Skill Directory",
"description": "scripts/package_skill.py walks every file beneath the provided skill directory and writes each one into the archive. Without exclusions, hidden files, caches, or local secrets placed in the skill folder could be shared unintentionally.",
"severity": "medium",
"locations": [
{
"file": "scripts/package_skill.py",
"line_start": 68,
"line_end": 74
}
],
"confidence": 0.82,
"confidence_reasoning": "The archive loop uses rglob over all files and writes each result without filtering. This is a clear packaging behavior, though impact depends on what files the user has placed in the skill directory."
}
],
"critical_findings": [],
"high_findings": [],
"medium_findings": [
{
"title": "Unvalidated Skill Name Controls Output Path",
"description": "scripts/init_skill.py combines the user-supplied output path with skill_name before creating directories and files. A name containing path separators or parent directory segments could write generated files outside the intended output folder.",
"locations": [
{
"file": "scripts/init_skill.py",
"line_start": 205,
"line_end": 215
},
{
"file": "scripts/init_skill.py",
"line_start": 287,
"line_end": 294
}
],
"review_kind": "security",
"source_category": "semantic",
"source_severity": "medium",
"confidence": 0.84,
"confidence_reasoning": "The code joins Path(path).resolve() with raw skill_name and then creates the directory. The CLI text states naming rules, but the script does not enforce them before filesystem writes."
},
{
"title": "Packager Archives All Files Under Skill Directory",
"description": "scripts/package_skill.py walks every file beneath the provided skill directory and writes each one into the archive. Without exclusions, hidden files, caches, or local secrets placed in the skill folder could be shared unintentionally.",
"locations": [
{
"file": "scripts/package_skill.py",
"line_start": 68,
"line_end": 74
}
],
"review_kind": "security",
"source_category": "semantic",
"source_severity": "medium",
"confidence": 0.82,
"confidence_reasoning": "The archive loop uses rglob over all files and writes each result without filtering. This is a clear packaging behavior, though impact depends on what files the user has placed in the skill directory."
}
],
"low_findings": [],
"dangerous_patterns": [],
"files_scanned": 7,
"total_lines": 1180,
"audit_model": "codex",
"audited_at": "2026-07-07T18:50:30.903Z",
"agent_auto_install_policy": "allowed",
"manual_install_policy": "allowed"
},
"content": {
"user_title": "Create Effective AI Skills",
"value_statement": "Building reusable AI skills requires clear structure, concise context, and safe packaging. This skill guides Claude, Codex, and Claude Code through planning, scaffolding, writing, validating, and packaging skills.",
"seo_keywords": [
"Claude",
"Codex",
"Claude Code",
"AI skill creator",
"skill authoring",
"SKILL.md template",
"agent workflow design",
"skill validation",
"skill packaging",
"progressive disclosure"
],
"actual_capabilities": [
"Explains the required SKILL.md structure and frontmatter fields.",
"Guides decisions about scripts, references, and assets for reusable workflows.",
"Scaffolds a new skill folder with starter files and resource directories.",
"Validates skill frontmatter, naming rules, and description constraints.",
"Packages a validated skill folder into a distributable .skill archive.",
"Provides reference patterns for workflow design and output examples."
],
"limitations": [
"It does not publish skills to any marketplace or registry.",
"Generated templates require user editing before they are useful.",
"Local scripts require Python and the expected dependencies to be installed.",
"The packager does not automatically filter every unintended file type."
],
"use_cases": [
{
"title": "Design a New Skill",
"description": "Plan triggers, workflows, and reusable resources for a new AI skill before writing files.",
"target_user": "AI workflow engineer"
},
{
"title": "Convert Team Process Notes",
"description": "Turn internal procedures into concise skill instructions with supporting references and examples.",
"target_user": "Documentation lead"
},
{
"title": "Validate and Package a Skill",
"description": "Check frontmatter and create a distributable .skill archive after implementation.",
"target_user": "Developer tooling maintainer"
}
],
"prompt_templates": [
{
"title": "Plan a New Skill",
"scenario": "Beginner prompt for defining scope and structure.",
"prompt": "Help me design a skill for [task]. Ask the minimum questions needed, then propose the SKILL.md structure and required resources."
},
{
"title": "Scaffold a Skill Folder",
"scenario": "Intermediate prompt for creating starter files.",
"prompt": "Use this skill to initialize a new [skill-name] skill under [path]. Then explain which generated files I should edit or delete."
},
{
"title": "Improve an Existing Skill",
"scenario": "Intermediate prompt for revising quality and trigger behavior.",
"prompt": "Review my existing skill for trigger clarity, progressive disclosure, resource organization, and packaging readiness. Suggest concrete edits before packaging."
},
{
"title": "Build a Multi-Domain Skill",
"scenario": "Advanced prompt for complex skills with many resources.",
"prompt": "Create an implementation plan for a multi-domain skill with scripts, references, assets, validation steps, packaging checks, and review criteria."
}
],
"output_examples": [
{
"input": "I need a skill for monthly metrics analysis.",
"output": "A concise skill plan with trigger wording, workflow sections, and a short list of scripts and reference files."
},
{
"input": "Initialize a new brand-guidelines skill.",
"output": "A local skill folder with SKILL.md, example resources, and next editing steps for replacing placeholders."
},
{
"input": "Package this skill for sharing.",
"output": "A validation result followed by an archive path, or clear fixes when validation fails."
}
],
"best_practices": [
"Start from real user requests before writing the skill body.",
"Keep SKILL.md concise and move large supporting detail into references.",
"Test bundled scripts with representative inputs before packaging."
],
"anti_patterns": [
"Adding process documents that do not help the agent perform the task.",
"Leaving generated placeholder files in the final package.",
"Using broad descriptions that cause the skill to trigger too often."
],
"faq": [
{
"question": "What does this skill help create?",
"answer": "It helps create AI skills with clear triggers, concise instructions, reusable resources, validation, and packaging."
},
{
"question": "Does it create files automatically?",
"answer": "Yes. The initializer can create a local skill folder, SKILL.md, and example resource directories."
},
{
"question": "Can it update an existing skill?",
"answer": "Yes. It includes guidance for reviewing triggers, resource structure, and iterative improvements."
},
{
"question": "Does it validate every security concern?",
"answer": "No. It checks basic structure, but users must review scripts, assets, and packaged files separately."
},
{
"question": "Which tools can use this skill?",
"answer": "The report lists support for Claude, Codex, and Claude Code."
},
{
"question": "Does it publish the skill?",
"answer": "No. It creates a local .skill archive that a user can share through a separate process."
}
]
},
"file_structure": [
{
"name": "LICENSE.txt",
"type": "file",
"path": "LICENSE.txt",
"lines": 202
},
{
"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": "__pycache__",
"type": "dir",
"path": "scripts/__pycache__",
"children": [
{
"name": "package_skill.cpython-313.pyc",
"type": "file",
"path": "scripts/__pycache__/package_skill.cpython-313.pyc",
"lines": 38
},
{
"name": "quick_validate.cpython-313.pyc",
"type": "file",
"path": "scripts/__pycache__/quick_validate.cpython-313.pyc",
"lines": 24
},
{
"name": "quick_validate.cpython-314.pyc",
"type": "file",
"path": "scripts/__pycache__/quick_validate.cpython-314.pyc",
"lines": 27
}
]
},
{
"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": "SKILL.md",
"type": "file",
"path": "SKILL.md",
"lines": 357
}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |