Skip to content

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

example-skill

Verified

This skill should be used when demonstrating skill structure and format. Provides example patterns for creating new skills.

FileKindSize
SKILL.mdskill md2.4 KB
references/structure-guide.mdmarkdown663 B
skill-report.jsonconfig11.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
    }
  ]
}
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: 471kUpdated 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