swift-skill-authoring

Guide creation and editing of Claude skills with structure and best practices.

1|Updated Feb 7, 2026

Search Tags:#best practices #prompt engineering #ai development #claude skills #skill authoring #developer guide

Ready to run

npx skills add https://github.com/gestrich/swift-app-architecture --skill swift-skill-authoring

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: swift-skill-authoring
Source: https://github.com/gestrich/swift-app-architecture/tree/main/.claude/skills/swift-skill-authoring
Command: npx skills add https://github.com/gestrich/swift-app-architecture --skill swift-skill-authoring

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill provides comprehensive guidance and best practices for creating, editing, and improving Claude Skills, ensuring efficient and effective skill development.

Core Features & Use Cases

Skill Structure: Understand the required and optional components of a Skill Unit, including SKILL.md, scripts/, references/, and assets/.
Best Practices: Learn naming conventions, description writing, progressive disclosure, and content guidelines for optimal skill design.
Use Case: When starting a new Claude Skill project, use this Skill to understand the fundamental structure, required frontmatter, and recommended file organization to ensure your skill is discoverable and maintainable.

Quick Start

Use the swift-skill-authoring skill to get a template for creating a new Claude skill.

Frequently Asked Questions about swift-skill-authoring

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

What is a Claude Skill and what components do I need to build one?▼

To create a Claude Skill, you need a SKILL.md file with proper frontmatter, and can optionally include scripts, references, and assets directories to organize supporting files and components.

How do I structure frontmatter and file organization for a new Claude Skill?▼

Claude Skill best practices require specific frontmatter fields, logical file organization, and concise content to ensure your skill is discoverable, maintainable, and follows progressive disclosure guidelines.

What are the best practices for writing Claude Skill descriptions and naming conventions?▼

Best practices for Claude Skill authoring include adhering to naming conventions, writing precise descriptions, using progressive disclosure, and maintaining concise content for optimal skill design.

Can I use existing scripts and references when creating a Claude Skill?▼

You can include scripts and references directories within your Claude Skill unit to provide supporting code and documentation, ensuring all components work together effectively.

How do I test a Claude Skill after authoring it?▼

Claude Skill testing methodologies focus on validating skill unit components, ensuring frontmatter fields, file organization, and content guidelines perform correctly within the development workflow.

When should I use progressive disclosure in Claude Skill development?▼

Progressive disclosure in Claude Skill authoring helps manage content complexity by structuring essential information upfront while organizing detailed references and assets separately for maintainability.