aiskillstore/marketplace / skills/89jobrien/example-skill
example-skill
VerifiedThis skill should be used when demonstrating skill structure and format. Provides example patterns for creating new skills.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.4 KB |
| references/structure-guide.md | markdown | 663 B |
| skill-report.json | config | 11.6 KB |
skill-report.json
View on GitHub{
"schema_version": "2.0",
"meta": {
"generated_at": "2026-07-05T12:10:04.985Z",
"slug": "89jobrien-example-skill",
"source_url": "https://github.com/89jobrien/steve/tree/main/steve/skills/example-skill",
"source_ref": "main",
"model": "codex",
"analysis_version": "3.0.0",
"source_type": "community",
"content_hash": "4d1e45ffe1059e5ca737c0e455d3f8db4fe961efedd844135233059d32ed886d",
"tree_hash": "afc415ed5a3fee615c829f54c73339a9471ec9302cfd154348950a669c68cacb",
"provenance": {
"model_effective": "codex",
"fallback_chain": [
{
"agent": "codex",
"outcome": "success"
}
],
"analysis_version": "3.0.0"
}
},
"skill": {
"name": "example-skill",
"description": "Demonstrates the structure, sections, workflow, and reference-file pattern for creating Claude Code skills.",
"summary": "Use a concise example to structure new AI skills.",
"icon": "π¦",
"version": "1.0.2",
"author": "Joseph OBrien",
"license": "MIT",
"category": "documentation",
"tags": [
"skill-authoring",
"templates",
"documentation",
"claude-code",
"best-practices"
],
"supported_tools": [
"claude",
"codex",
"claude-code"
],
"risk_factors": [
"external_commands"
]
},
"security_audit": {
"risk_level": "safe",
"is_blocked": false,
"safe_to_publish": true,
"analysis_status": "ok",
"summary": "The static findings are false positives caused by Markdown inline code and ordinary documentation text. I found no command execution, system reconnaissance behavior, prompt injection, network access, secret access, or data exfiltration intent.",
"remediation": [],
"risk_factor_evidence": [
{
"factor": "external_commands",
"evidence": [
{
"file": "SKILL.md",
"line_start": 85,
"line_end": 85
},
{
"file": "SKILL.md",
"line_start": 91,
"line_end": 91
},
{
"file": "SKILL.md",
"line_start": 93,
"line_end": 93
},
{
"file": "SKILL.md",
"line_start": 94,
"line_end": 94
}
]
}
],
"static_findings": [
{
"id": "external_commands:SKILL.md:85:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 85,
"line_end": 85,
"snippet": "2. Use the template from `steve/templates/AGENT_SKILL.template.md`"
},
{
"id": "external_commands:SKILL.md:91:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 91,
"line_end": 91,
"snippet": "This skill includes reference files in `references/`:"
},
{
"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": 93,
"snippet": "- `structure-guide.md`: Detailed structure guidelines"
},
{
"id": "external_commands:SKILL.md:94:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 94,
"line_end": 94,
"snippet": "- `examples.md`: Additional examples"
},
{
"id": "blocker:SKILL.md:66:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "SKILL.md",
"line_start": 66,
"line_end": 66,
"snippet": "- Document anti-patterns to avoid common mistakes"
}
],
"finding_verdicts": [
{
"id": "external_commands:SKILL.md:85:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "Line 85 contains a Markdown inline-code path to a template file. It does not execute a shell command or instruct the model to run one."
},
{
"id": "external_commands:SKILL.md:91:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "Line 91 uses Markdown inline code to name the references directory. There is no Ruby backtick execution or command invocation."
},
{
"id": "external_commands:SKILL.md:93:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "Line 93 uses Markdown inline code for the file name structure-guide.md. The text is documentation and does not execute external commands."
},
{
"id": "external_commands:SKILL.md:94:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "Line 94 uses Markdown inline code for the file name examples.md. It is a documented reference and not executable shell syntax."
},
{
"id": "blocker:SKILL.md:66:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "Line 66 tells authors to document anti-patterns. It does not gather system data, enumerate files, or inspect the host environment."
}
],
"semantic_findings": [],
"critical_findings": [],
"high_findings": [],
"medium_findings": [],
"low_findings": [],
"dangerous_patterns": [],
"files_scanned": 2,
"total_lines": 125,
"audit_model": "codex",
"audited_at": "2026-07-05T12:10:04.985Z",
"agent_auto_install_policy": "allowed",
"manual_install_policy": "allowed"
},
"content": {
"user_title": "Build Better AI Skills",
"value_statement": "Skill authors need a clear pattern for structure, workflow, and bundled references. This skill provides a concise example they can follow when creating Claude, Codex, or Claude Code skills.",
"seo_keywords": [
"Claude",
"Codex",
"Claude Code",
"AI skill template",
"skill authoring",
"skill documentation",
"skill structure",
"example skill",
"reference files",
"workflow guide"
],
"actual_capabilities": [
"Shows required YAML frontmatter fields for a skill.",
"Explains when to use an example skill as a reference.",
"Lists core principles for focused skill documentation.",
"Provides a four-step workflow for applying the example.",
"Identifies common anti-patterns for skill authors.",
"Links to a reference guide for structure details."
],
"limitations": [
"It is a documentation example, not an automation tool.",
"It does not create files or install dependencies.",
"It includes a reference to examples.md, but that file is not present.",
"It gives general guidance and not domain-specific skill content."
],
"use_cases": [
{
"title": "Plan a First Skill",
"description": "Use the example to understand the expected sections before writing a new skill.",
"target_user": "First-time skill creator"
},
{
"title": "Review Skill Structure",
"description": "Compare an existing skill against the example sections and documented anti-patterns.",
"target_user": "Marketplace maintainer"
},
{
"title": "Improve Skill Documentation",
"description": "Check whether workflows, examples, and reference files are clear for future users.",
"target_user": "Documentation reviewer"
}
],
"prompt_templates": [
{
"title": "Explain the Skill Format",
"scenario": "Beginner review of skill structure.",
"prompt": "Use example-skill to explain the required sections for a new skill. Keep the answer concise and include a checklist."
},
{
"title": "Draft a Skill Outline",
"scenario": "Planning a new skill from the example.",
"prompt": "Use example-skill as a model. Draft an outline for a skill that helps with release notes."
},
{
"title": "Review an Existing Skill",
"scenario": "Checking structure before publication.",
"prompt": "Compare my skill draft with example-skill. Identify missing sections, unclear workflow steps, and weak examples."
},
{
"title": "Create a Publication Checklist",
"scenario": "Advanced marketplace preparation.",
"prompt": "Use example-skill and its structure guide to create a publication checklist for a team skill review process."
}
],
"output_examples": [
{
"input": "Explain what sections my new skill should include.",
"output": [
"When to Use: Define the trigger conditions.",
"What This Skill Does: State specific capabilities.",
"Workflow: Provide steps a user can follow.",
"Examples: Show realistic usage scenarios."
]
},
{
"input": "Review my skill draft for structure gaps.",
"output": [
"The draft has a clear purpose and workflow.",
"Add an Anti-Patterns section to prevent common misuse.",
"Add a reference file only if it improves the user workflow."
]
},
{
"input": "Help me prepare a team checklist for skill publication.",
"output": "The checklist should verify trigger conditions, frontmatter, workflow steps, examples, bundled references, and documented limitations."
}
],
"best_practices": [
"Use the example as a structural reference before writing domain content.",
"Keep each new skill focused on one clear capability.",
"Add reference files only when they improve the workflow."
],
"anti_patterns": [
"Do not copy placeholder content into a published skill.",
"Do not create broad skills that cover unrelated tasks.",
"Do not reference missing files in user-facing documentation."
],
"faq": [
{
"question": "What is this skill for?",
"answer": "It shows a simple structure for creating and reviewing AI skills."
},
{
"question": "Does it create a new skill automatically?",
"answer": "No. It provides documentation guidance that a user or agent can follow."
},
{
"question": "Which tools can use this skill?",
"answer": "The report lists support for Claude, Codex, and Claude Code."
},
{
"question": "Does it include reference material?",
"answer": "Yes. It includes a structure guide in the references directory."
},
{
"question": "Is it safe to install?",
"answer": "The reviewed files contain documentation only. No executable behavior was found."
},
{
"question": "What should authors watch for?",
"answer": "Authors should avoid broad scope, missing examples, and references to files that are not included."
}
]
},
"file_structure": [
{
"name": "references",
"type": "dir",
"path": "references",
"children": [
{
"name": "structure-guide.md",
"type": "file",
"path": "references/structure-guide.md",
"lines": 30
}
]
},
{
"name": "SKILL.md",
"type": "file",
"path": "SKILL.md",
"lines": 95
}
]
}
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: 471k | 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 |