Skip to content

bigchewy/skills

Repository files navigation

Claude Skills Repository

A collection of reusable, portable skills for Claude Code and Claude.ai that enhance document creation, analysis, and workflow automation capabilities.

Purpose

This repository provides a centralized collection of Claude skills focused on:

  • Document creation and templates
  • Strategic planning and analysis
  • Marketing and positioning materials
  • Business communication
  • Technical documentation
  • Content strategy and planning

Skills are designed to be portable and can be loaded into any project, providing consistent capabilities across different contexts.

Repository Structure

skills/
├── tools/                    # Skill creation and packaging tools
│   ├── init_skill.py        # Initialize new skills from template
│   ├── package_skill.py     # Package skills as distributable ZIPs
│   └── quick_validate.py    # Validate skill structure and metadata
├── skills/                   # Individual skill directories
│   └── [skill-name]/        # Each skill lives in its own directory
│       ├── SKILL.md         # Skill definition and instructions
│       ├── scripts/         # Executable helper scripts (optional)
│       ├── references/      # Documentation loaded into context (optional)
│       └── assets/          # Templates and files for output (optional)
├── dist/                     # Packaged ZIP files ready for distribution
└── README.md

Planned Skills

Strategic Documents

  • strategy-doc-creator - Business strategy documents and frameworks
  • positioning-doc-creator - Product and company positioning statements
  • go-to-market-strategy - GTM planning and execution documents
  • competitive-analysis - Market and competitor analysis frameworks

Marketing Content

  • marketing-strategy - Comprehensive marketing plans and campaigns
  • social-media-strategy - Social media content calendars and strategies
  • content-strategy - Content planning and editorial calendars
  • messaging-framework - Brand messaging and value propositions
  • campaign-brief - Marketing campaign briefs and creative direction

Business Documents

  • business-case - Business case and ROI analysis documents
  • executive-summary - Executive summaries and briefings
  • project-charter - Project initiation and charter documents
  • stakeholder-communication - Stakeholder updates and communications

Technical Documentation

  • technical-spec - Technical specifications and architecture docs
  • api-documentation - API documentation and integration guides
  • user-guide - End-user documentation and how-to guides

Quick Start

Creating a New Skill

  1. Use the init_skill.py tool to create a new skill from the template:
python tools/init_skill.py my-new-skill --path skills
  1. Edit the generated skills/my-new-skill/SKILL.md file:

    • Update the YAML frontmatter (name and description)
    • Follow the structure guidance in the template
    • Add your skill content and instructions
    • Remove or customize the example resource files
  2. Validate your skill:

python tools/quick_validate.py skills/my-new-skill
  1. Package your skill for distribution:
python tools/package_skill.py skills/my-new-skill dist

This creates dist/my-new-skill.zip ready to share or install.

Installing a Skill in Another Project

Option 1: Install from ZIP

  1. Download or copy the skill ZIP file
  2. Extract to your project's .claude/skills/ directory
  3. The skill is now available in Claude Code

Option 2: Install from Repository

  1. Clone or copy the skill directory
  2. Copy skills/[skill-name]/ to your project's .claude/skills/[skill-name]/
  3. The skill is now available in Claude Code

Option 3: Symlink for Development For active development, symlink skills to test changes immediately:

ln -s /path/to/skills/skills/my-skill ~/.claude/skills/my-skill

Development Workflow

Standard Workflow

  1. Initialize - Create skill structure with init_skill.py
  2. Develop - Write skill content in SKILL.md and add resources
  3. Validate - Check structure with quick_validate.py
  4. Test - Install in a test project and verify functionality
  5. Package - Create distributable ZIP with package_skill.py
  6. Distribute - Share ZIP or commit to repository

Best Practices

  • Clear descriptions - Include WHEN to use the skill in the description
  • Progressive disclosure - Start simple, provide detail on request
  • Concrete examples - Include realistic user requests and outputs
  • Resource organization - Use scripts/, references/, and assets/ appropriately
  • Validation - Always validate before packaging
  • Testing - Test skills in real projects before distribution

See DEVELOPMENT.md for comprehensive development guidelines.

Tool Reference

init_skill.py

Creates a new skill from template with proper structure.

python tools/init_skill.py <skill-name> --path <path>

Arguments:

  • skill-name - Hyphen-case name (lowercase letters, digits, hyphens only)
  • --path - Directory where skill folder will be created

Example:

python tools/init_skill.py content-strategy --path skills

package_skill.py

Packages a skill directory into a distributable ZIP file.

python tools/package_skill.py <skill-path> [output-dir]

Arguments:

  • skill-path - Path to the skill directory
  • output-dir - Optional output directory (defaults to current directory)

Example:

python tools/package_skill.py skills/content-strategy dist

quick_validate.py

Validates skill structure and metadata.

python tools/quick_validate.py <skill-path>

Checks:

  • SKILL.md exists
  • Valid YAML frontmatter
  • Required fields present (name, description)
  • Naming conventions followed
  • No invalid characters

Example:

python tools/quick_validate.py skills/content-strategy

Resources

Official Documentation

Skill Development

  • See DEVELOPMENT.md for detailed development guidelines
  • Review existing skills in the skills/ directory for examples
  • Reference Anthropic's public skills for patterns and best practices

Related Projects

  • ai-tools - Claude Code plugins and MCP servers

Contributing

Contributions are welcome! To contribute a new skill:

  1. Fork the repository
  2. Create a new skill using the tools
  3. Test thoroughly in a real project
  4. Submit a pull request with:
    • The skill directory
    • Packaged ZIP in dist/
    • Updated README if adding a new category

License

MIT License - See LICENSE for details.

Support

For issues or questions:

About

Reusable Claude skills for document creation, strategy planning, and workflow automation

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages