skills/barissozen/skill-creator/SKILL.md
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.
npx skillsauth add aiskillstore/marketplace skill-creatorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
This skill provides guidance for creating effective skills.
Gather examples of how the skill will be used.
Identify scripts, references, and assets needed.
Run init_skill.py to create directory structure.
Define purpose, triggers, and workflow.
Run package_skill.py to validate and zip.
Test and improve based on real usage.
Skills are modular, self-contained packages that extend Claude's capabilities by providing specialized knowledge, workflows, and tools. Think of them as "onboarding guides" for specific domains or tasks—they transform Claude from a general-purpose agent into a specialized agent equipped with procedural knowledge that no model can fully possess.
Every skill consists of a required SKILL.md file and optional bundled resources:
skill-name/
├── SKILL.md (required)
│ ├── YAML frontmatter metadata (required)
│ │ ├── name: (required)
│ │ └── description: (required)
│ └── Markdown instructions (required)
└── Bundled Resources (optional)
├── scripts/ - Executable code (Python/Bash/etc.)
├── references/ - Documentation to load into context as needed
└── assets/ - Files used in output (templates, icons, fonts, etc.)
Skills use a three-level loading system to manage context efficiently:
*Unlimited because scripts can be executed without reading into context window.
To create an effective skill, clearly understand concrete examples of how the skill will be used.
Questions to ask:
Analyze each example by:
When to use scripts/: When the same code is being rewritten repeatedly or deterministic reliability is needed.
When to use references/: For documentation that Claude should reference while working (schemas, API docs, policies).
When to use assets/: For files used in output (templates, images, boilerplate code).
Run the initialization script to create the skill structure:
python .claude/skills/skill-creator/scripts/init_skill.py <skill-name> --path <output-directory>
Writing Style: Use imperative/infinitive form (verb-first instructions), not second person.
Answer these questions in SKILL.md:
python .claude/skills/skill-creator/scripts/package_skill.py <path/to/skill-folder>
After testing, improve based on real usage:
development
Apple Human Interface Guidelines for content display components. Use this skill when the user asks about charts component, collection view, image view, web view, color well, image well, activity view, lockup, data visualization, content display, displaying images, rendering web content, color pickers, or presenting collections of items in Apple apps. Also use when the user says how should I display charts, what's the best way to show images, should I use a web view, how do I build a grid of items, what component shows media, or how do I present a share sheet. Cross-references: hig-foundations for color/typography/accessibility, hig-patterns for data visualization patterns, hig-components-layout for structural containers, hig-platforms for platform-specific component behavior.
tools
Automate HelpDesk tasks via Rube MCP (Composio): list tickets, manage views, use canned responses, and configure custom fields. Always search tools first for current schemas.
testing
Expert Haskell engineer specializing in advanced type systems, pure functional design, and high-reliability software. Use PROACTIVELY for type-level programming, concurrency, and architecture guidance.
tools
GraphQL gives clients exactly the data they need - no more, no less. One endpoint, typed schema, introspection. But the flexibility that makes it powerful also makes it dangerous. Without proper controls, clients can craft queries that bring down your server. This skill covers schema design, resolvers, DataLoader for N+1 prevention, federation for microservices, and client integration with Apollo/urql. Key insight: GraphQL is a contract. The schema is the API documentation. Design it carefully.