Claude Skills Library

Production-ready skill packages for Claude AI - Reusable expertise bundles combining best practices, analysis tools, and strategic frameworks for marketing teams and executive leadership.

---

📚 Table of Contents

• Overview
• Available Skills
• Quick Start
• How to Use with Claude AI
• How to Use with Claude Code
• Skill Architecture
• Installation
• Usage Examples
• Roadmap
• Contributing
• License
• Author

---

🎯 Overview

This repository provides modular, self-contained skill packages designed to augment Claude AI with specialized domain expertise. Each skill includes:

• 📖 Comprehensive documentation - Workflows, best practices, and strategic frameworks
• 🛠️ Python analysis tools - CLI utilities for automated analysis and optimization
• 📚 Knowledge bases - Curated reference materials and guidelines
• 📋 Ready-to-use templates - Customizable assets for immediate deployment

Key Benefits:

• ⚡ Immediate deployment - Download and use in minutes
• 🎯 Domain expertise - Battle-tested frameworks from industry experts
• 🔧 Practical tools - Algorithmic analysis without external API dependencies
• 📈 Measurable ROI - 40%+ time savings, 30%+ quality improvements

---

🚀 Available Skills

Marketing Skills

📝 Content Creator

Status: ✅ Production Ready | Version: 1.0

Transform your content creation process with professional-grade tools and frameworks.

What's Included:

• Brand Voice Analyzer - Analyze text for tone, formality, and readability (Python CLI)
• SEO Optimizer - Comprehensive SEO scoring and optimization recommendations (Python CLI)
• Brand Guidelines - 5 personality archetypes and voice framework
• Content Frameworks - 15+ templates (blog posts, emails, social media, video scripts)
• Social Media Optimization - Platform-specific guides for LinkedIn, Twitter/X, Instagram, Facebook, TikTok
• Content Calendar Template - Monthly planning and distribution framework

Core Workflows:

1. Brand voice development and consistency
2. SEO-optimized content creation
3. Platform-specific social media content
4. Content calendar planning and execution

Learn More: marketing-skill/content-creator/SKILL.md

---

C-Level Advisory Skills

👔 CEO Advisor

Status: ✅ Production Ready | Version: 1.0

Executive leadership guidance for strategic decision-making, organizational development, and stakeholder management.

What's Included:

• Strategy Analyzer - Evaluate strategic initiatives and competitive positioning (Python CLI)
• Financial Scenario Analyzer - Model financial scenarios and business outcomes (Python CLI)
• Executive Decision Framework - Structured decision-making methodology
• Leadership & Organizational Culture - Culture building and change management
• Board Governance & Investor Relations - Stakeholder communication best practices

Core Workflows:

1. Strategic planning and initiative evaluation
2. Financial scenario modeling
3. Board and investor communication
4. Organizational culture development

Learn More: c-level-advisor/ceo-advisor/SKILL.md

---

💻 CTO Advisor

Status: ✅ Production Ready | Version: 1.0

Technical leadership guidance for engineering teams, architecture decisions, and technology strategy.

What's Included:

• Tech Debt Analyzer - Quantify and prioritize technical debt (Python CLI)
• Team Scaling Calculator - Model engineering team growth and structure (Python CLI)
• Engineering Metrics Framework - DORA metrics, velocity, and quality indicators
• Technology Evaluation Framework - Structured approach to technology selection
• Architecture Decision Records - ADR templates and best practices

Core Workflows:

1. Technical debt assessment and management
2. Engineering team scaling and structure
3. Technology evaluation and selection
4. Architecture decision documentation

Learn More: c-level-advisor/cto-advisor/SKILL.md

---

⚡ Quick Start

For Claude AI Users

1. Download the skill package you need (or clone this repository)
2. Upload the SKILL.md file to your Claude conversation
3. Reference the skill: "Using the content-creator skill, help me write a LinkedIn post about AI"

For Claude Code Users

1. Clone this repository into your project
2. Load the skill in your Claude Code session
3. Execute workflows and run analysis tools directly

---

🤖 How to Use with Claude AI

Claude AI can use these skills to provide specialized expertise in your conversations.

Method 1: Upload Skill Documentation

Step-by-Step:

1. Navigate to the skill folder you want to use (e.g., marketing-skill/content-creator/)

2. Upload the SKILL.md file to your Claude conversation:

   • Click the attachment icon 📎
   • Select SKILL.md from the skill folder
   • Upload to the conversation

3. Reference the skill in your prompts:

   Using the content-creator skill, help me:
   - Write a blog post about sustainable technology
   - Analyze my brand voice from these 3 articles
   - Create a LinkedIn content calendar for November 2025
   

4. Access reference materials as needed:

   • Upload specific reference files (e.g., references/content_frameworks.md)
   • Claude will use the frameworks to guide content creation

Method 2: Use Packaged .zip Archives

For easy sharing with your team:

1. Download the pre-packaged .zip file (e.g., content-creator.zip)
2. Extract to your local machine
3. Upload SKILL.md to Claude as described above

Example Prompts

Content Creator Skill:

Using the content-creator skill:
1. Analyze this article for brand voice consistency
2. Optimize this blog post for the keyword "marketing automation"
3. Create a 30-day LinkedIn content calendar for our product launch
4. Write a Twitter thread explaining our new feature

CEO Advisor Skill:

Using the ceo-advisor skill:
1. Help me evaluate our product expansion strategy
2. Create a board presentation for Q4 results
3. Model financial scenarios for hiring 10 new salespeople
4. Draft investor update email for our Series A round

CTO Advisor Skill:

Using the cto-advisor skill:
1. Analyze our technical debt and create a reduction roadmap
2. Calculate optimal team structure for scaling to 50 engineers
3. Evaluate whether we should adopt GraphQL or stick with REST
4. Create an ADR for our microservices migration decision

Tips for Best Results

✅ DO:

• Reference the skill name explicitly in your prompts
• Upload relevant reference materials for complex tasks
• Ask Claude to use specific frameworks or templates from the skill
• Provide context about your industry, audience, or constraints

❌ DON'T:

• Assume Claude remembers the skill across different conversations (re-upload if needed)
• Mix too many skills in one conversation (focus on one domain at a time)
• Skip uploading the SKILL.md file (it contains essential workflows)

---

💻 How to Use with Claude Code

Claude Code can execute the Python analysis tools and integrate skills into your development workflow.

Setup

1. Clone this repository into your project or workspace:

   git clone https://github.com/alirezarezvani/claude-skills.git
   cd claude-skills
   

2. Install Python dependencies (if needed):

   # Most scripts use standard library only
   pip install pyyaml  # Optional, for future features
   

3. Verify installation:

   python marketing-skill/content-creator/scripts/brand_voice_analyzer.py --help
   python marketing-skill/content-creator/scripts/seo_optimizer.py --help
   

Using Analysis Tools

Brand Voice Analyzer

Analyze any text file for brand voice characteristics and readability:

# Analyze with human-readable output
python marketing-skill/content-creator/scripts/brand_voice_analyzer.py article.txt

# Analyze with JSON output for automation
python marketing-skill/content-creator/scripts/brand_voice_analyzer.py article.txt json

Output includes:

• Formality score (informal → formal scale)
• Tone analysis (professional, friendly, authoritative, etc.)
• Perspective (first-person, third-person)
• Flesch Reading Ease score
• Sentence structure analysis
• Improvement recommendations

SEO Optimizer

Comprehensive SEO analysis and optimization:

# Basic SEO analysis
python marketing-skill/content-creator/scripts/seo_optimizer.py blog-post.md "primary keyword"

# With secondary keywords
python marketing-skill/content-creator/scripts/seo_optimizer.py blog-post.md "marketing automation" "email marketing,lead nurturing"

Output includes:

• SEO score (0-100)
• Keyword density analysis (primary, secondary, LSI keywords)
• Content structure evaluation (headings, paragraphs, links)
• Readability assessment
• Meta tag suggestions (title, description, URL, OG tags)
• Actionable optimization recommendations

Tech Debt Analyzer (CTO Advisor)

Quantify and prioritize technical debt:

python c-level-advisor/cto-advisor/scripts/tech_debt_analyzer.py /path/to/codebase

Team Scaling Calculator (CTO Advisor)

Model engineering team growth:

python c-level-advisor/cto-advisor/scripts/team_scaling_calculator.py --current-size 10 --target-size 50

Financial Scenario Analyzer (CEO Advisor)

Model business scenarios:

python c-level-advisor/ceo-advisor/scripts/financial_scenario_analyzer.py scenarios.yaml

Strategy Analyzer (CEO Advisor)

Evaluate strategic initiatives:

python c-level-advisor/ceo-advisor/scripts/strategy_analyzer.py strategy-doc.md

Integrating with Claude Code Workflows

Example 1: Automated Content Quality Check

# In your Claude Code session:
# 1. Write content using content-creator frameworks
# 2. Run automated analysis
python marketing-skill/content-creator/scripts/seo_optimizer.py output.md "target keyword"
python marketing-skill/content-creator/scripts/brand_voice_analyzer.py output.md json

# 3. Claude Code reviews results and suggests improvements

Example 2: Technical Debt Tracking

# Run monthly tech debt analysis
python c-level-advisor/cto-advisor/scripts/tech_debt_analyzer.py src/

# Claude Code generates report and roadmap
# Tracks progress over time

Example 3: Content Pipeline Automation

Create a workflow in Claude Code:

1. Generate content using content frameworks
2. Auto-run SEO optimizer on all drafts
3. Flag content below SEO score threshold (< 75)
4. Apply recommendations automatically
5. Re-score and validate

Advanced: Custom Skill Development

Use this repository as a template to build your own skills:

1. Fork this repository
2. Create new skill folder following the architecture pattern
3. Develop your domain-specific tools and frameworks
4. Document workflows in SKILL.md
5. Share with your team or contribute back

See CLAUDE.md for detailed architecture and development guidelines.

---

🏗️ Skill Architecture

Each skill package follows a consistent, modular structure:

{skill-category}/
└── {skill-name}/
    ├── SKILL.md                          # Master documentation
    ├── scripts/                          # Python CLI tools
    │   ├── {tool_name}.py               # Executable analysis tools
    │   └── ...
    ├── references/                       # Knowledge bases
    │   ├── {framework_name}.md          # Curated guidelines
    │   └── ...
    └── assets/                           # User templates
        ├── {template_name}.md           # Ready-to-use templates
        └── ...

Design Principles

1. Self-Contained - Each skill is fully independent and deployable
2. Documentation-Driven - Success depends on clear, actionable documentation
3. Algorithm Over AI - Use deterministic analysis (code) when possible for speed and reliability
4. Template-Heavy - Provide ready-to-use frameworks users can customize
5. Platform-Specific - Focus on specific, actionable advice over generic best practices

Component Responsibilities

Component	Purpose	Format
SKILL.md	Entry point, workflows, usage instructions	Markdown
scripts/	Automated analysis and optimization tools	Python CLI
references/	Expert knowledge, frameworks, guidelines	Markdown
assets/	Templates for end-user customization	Markdown/YAML

---

📦 Installation

Prerequisites

• Python 3.7+ (for running analysis scripts)
• Claude AI account or Claude Code (for using skills)
• Git (for cloning repository)

Clone Repository

git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills

Install Dependencies

Most scripts use Python standard library only. Optional dependencies:

pip install pyyaml  # For future features

Verify Installation

# Test content creator tools
python marketing-skill/content-creator/scripts/brand_voice_analyzer.py --help
python marketing-skill/content-creator/scripts/seo_optimizer.py --help

# Test CTO advisor tools
python c-level-advisor/cto-advisor/scripts/tech_debt_analyzer.py --help
python c-level-advisor/cto-advisor/scripts/team_scaling_calculator.py --help

# Test CEO advisor tools
python c-level-advisor/ceo-advisor/scripts/strategy_analyzer.py --help
python c-level-advisor/ceo-advisor/scripts/financial_scenario_analyzer.py --help

---

📖 Usage Examples

Example 1: Blog Post Optimization

Scenario: You've written a blog post and want to optimize it for SEO and brand consistency.

# Step 1: Check SEO
python marketing-skill/content-creator/scripts/seo_optimizer.py blog-post.md "AI automation"

# Output: SEO Score: 68/100
# Recommendations:
# - Add 3 more mentions of primary keyword (current density: 0.8%, target: 1-2%)
# - Include H2 heading with primary keyword
# - Add 2 internal links
# - Meta description too short (current: 120 chars, target: 150-160)

# Step 2: Check brand voice
python marketing-skill/content-creator/scripts/brand_voice_analyzer.py blog-post.md

# Output:
# Formality: 7/10 (Professional)
# Tone: Authoritative, Informative
# Readability: 65 (Standard - college level)
# Recommendations:
# - Reduce sentence length by 15% for better readability
# - Use more active voice (currently 60%, target: 70%+)

# Step 3: Apply fixes in your editor
# Step 4: Re-run analysis to verify improvements

Example 2: LinkedIn Content Calendar

Using Claude AI:

1. Upload marketing-skill/content-creator/SKILL.md

2. Prompt:

   Using the content-creator skill, create a 30-day LinkedIn content calendar
   for our B2B SaaS company launching a new marketing automation feature.
   
   Target audience: Marketing directors at mid-sized companies (50-500 employees)
   Brand voice: Expert + Friendly (from the 5 archetypes)
   Topics: Marketing automation, lead nurturing, ROI measurement
   

3. Claude generates:

   • 30-day calendar with post types (how-to, case study, tips, thought leadership)
   • Specific post outlines using content frameworks
   • Optimal posting times based on LinkedIn best practices
   • Hashtag recommendations
   • Engagement strategies

Example 3: Technical Debt Assessment

Using Claude Code:

# Run tech debt analysis
python c-level-advisor/cto-advisor/scripts/tech_debt_analyzer.py /path/to/codebase

# Claude Code processes results and:
# 1. Identifies top 10 debt items by severity
# 2. Estimates effort to address (hours/days)
# 3. Calculates impact on velocity
# 4. Generates prioritized roadmap
# 5. Creates Jira tickets with detailed descriptions

# Output: Quarterly tech debt reduction plan

Example 4: Board Presentation Prep

Using CEO Advisor Skill:

1. Upload c-level-advisor/ceo-advisor/SKILL.md

2. Upload c-level-advisor/ceo-advisor/references/board_governance_investor_relations.md

3. Prompt:

   Using the ceo-advisor skill, help me prepare a board presentation for Q4 2025.
   
   Context:
   - SaaS company, $5M ARR, 40% YoY growth
   - Raised Series A ($10M) 18 months ago
   - Runway: 24 months
   - Key decision: Expand to European market or double-down on US
   
   Include: Financial summary, strategic options, recommendation, Q&A prep
   

4. Claude generates:

   • Structured presentation outline using board governance best practices
   • Financial scenario models for both options
   • Risk analysis and mitigation strategies
   • Anticipated board questions with prepared answers
   • Decision framework showing evaluation criteria

---

🗺️ Roadmap

Current Status (Q4 2025)

✅ Completed:

• Content Creator skill (v1.0) - Production ready
• CEO Advisor skill (v1.0) - Production ready
• CTO Advisor skill (v1.0) - Production ready

Phase 2: Core Expansion (Q1 2026)

🔄 In Planning:

• SEO Optimizer Skill - Deep SEO analysis and optimization (standalone expansion)
• Social Media Manager Skill - Campaign management across platforms
• Campaign Analytics Skill - Performance measurement and optimization

Phase 3: Enhancement (Q2 2026)

📋 Planned:

• Email Marketing Skill - Campaign creation, A/B testing, deliverability
• Paid Ads Manager Skill - Google Ads, Meta Ads, LinkedIn Ads optimization
• Competitor Intelligence Skill - Competitive analysis and positioning

Phase 4: Advanced (Q3 2026)

💡 Proposed:

• Conversion Optimizer Skill - Landing pages, funnels, CRO frameworks
• Influencer Outreach Skill - Partnership development and management
• Custom Skills - Based on community feedback and requests

Projected Impact

Metric	Current	Target (Q3 2026)
Available Skills	3	12+
Time Savings	40%	50%
Quality Improvement	30%	40%
Teams Using	Early adopters	500+

See detailed roadmap: marketing-skill/marketing_skills_roadmap.md

---

🤝 Contributing

Contributions are welcome! This repository aims to democratize professional expertise through reusable skill packages.

How to Contribute

1. Fork this repository
2. Create a feature branch (git checkout -b feature/new-skill)
3. Develop your skill following the architecture guidelines in CLAUDE.md
4. Test your tools and validate documentation
5. Submit a pull request with detailed description

Contribution Ideas

• New Skills - Domain expertise in your field (finance, HR, product management, etc.)
• Tool Enhancements - Improve existing Python analysis scripts
• Framework Additions - Add new templates or methodologies to existing skills
• Documentation - Improve how-to guides, examples, or translations
• Bug Fixes - Fix issues in scripts or documentation

Quality Standards

All contributions should:

• ✅ Follow the modular skill architecture pattern
• ✅ Include comprehensive SKILL.md documentation
• ✅ Provide actionable, specific guidance (not generic advice)
• ✅ Use algorithmic tools (Python) when possible, not just documentation
• ✅ Include ready-to-use templates or examples
• ✅ Be self-contained and independently deployable

---

📄 License

This project is licensed under the MIT License - see below for details.

MIT License

Copyright (c) 2025 Alireza Rezvani

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

You are free to:

• ✅ Use these skills commercially
• ✅ Modify and adapt to your needs
• ✅ Distribute to your team or clients
• ✅ Create derivative works

---

👤 Author

Alireza Rezvani

Building AI-powered tools and frameworks to democratize professional expertise.

• 🌐 Website: alirezarezvani.com
• 📝 Blog: medium.com/@alirezarezvani
• 💼 LinkedIn: Connect for updates on new skills and AI developments
• 📧 Contact: Available through website or blog

About This Project

This repository emerged from years of experience building marketing strategies, leading engineering teams, and advising executives. The goal is simple: make world-class expertise accessible to everyone through Claude AI.

Each skill represents hundreds of hours of domain expertise, distilled into actionable frameworks and automated tools. By sharing these openly, I hope to help teams work smarter, move faster, and achieve better results.

Follow my journey building AI-powered professional tools on Medium.

---

🙏 Acknowledgments

• Anthropic - For building Claude AI and Claude Code, making this possible
• Early Adopters - Teams testing these skills and providing feedback
• Open Source Community - For tools and libraries that power the analysis scripts

---

📞 Support & Feedback

Getting Help

• Documentation Issues: Open an issue in this repository
• Skill Requests: Submit a feature request describing your use case
• General Questions: Reach out via my website or blog

Sharing Your Success

Using these skills successfully? I'd love to hear about it:

• Share your story on social media (tag me!)
• Write about your experience on Medium
• Submit a case study for inclusion in this README

---

⭐ Star this repository if you find these skills useful!

🔗 Share with teams who could benefit from AI-powered expertise

🚀 Built with Claude AI | 📦 Packaged for Impact | 🌍 Open for All