diff --git a/README.md b/README.md new file mode 100644 index 0000000..c06e995 --- /dev/null +++ b/README.md @@ -0,0 +1,702 @@ +# 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. + +[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) +[![Claude AI](https://img.shields.io/badge/Claude-AI-blue.svg)](https://claude.ai) +[![Claude Code](https://img.shields.io/badge/Claude-Code-purple.svg)](https://claude.ai/code) + +--- + +## πŸ“š Table of Contents + +- [Overview](#overview) +- [Available Skills](#available-skills) +- [Quick Start](#quick-start) +- [How to Use with Claude AI](#how-to-use-with-claude-ai) +- [How to Use with Claude Code](#how-to-use-with-claude-code) +- [Skill Architecture](#skill-architecture) +- [Installation](#installation) +- [Usage Examples](#usage-examples) +- [Roadmap](#roadmap) +- [Contributing](#contributing) +- [License](#license) +- [Author](#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](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](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](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: + ```bash + git clone https://github.com/alirezarezvani/claude-skills.git + cd claude-skills + ``` + +2. **Install Python dependencies** (if needed): + ```bash + # Most scripts use standard library only + pip install pyyaml # Optional, for future features + ``` + +3. **Verify installation**: + ```bash + 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: + +```bash +# 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: + +```bash +# 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: + +```bash +python c-level-advisor/cto-advisor/scripts/tech_debt_analyzer.py /path/to/codebase +``` + +#### Team Scaling Calculator (CTO Advisor) + +Model engineering team growth: + +```bash +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: + +```bash +python c-level-advisor/ceo-advisor/scripts/financial_scenario_analyzer.py scenarios.yaml +``` + +#### Strategy Analyzer (CEO Advisor) + +Evaluate strategic initiatives: + +```bash +python c-level-advisor/ceo-advisor/scripts/strategy_analyzer.py strategy-doc.md +``` + +### Integrating with Claude Code Workflows + +**Example 1: Automated Content Quality Check** + +```bash +# 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** + +```bash +# 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](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 + +```bash +git clone https://github.com/alirezarezvani/claude-skills.git +cd claude-skills +``` + +### Install Dependencies + +Most scripts use Python standard library only. Optional dependencies: + +```bash +pip install pyyaml # For future features +``` + +### Verify Installation + +```bash +# 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. + +```bash +# 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:** + +```bash +# 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](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](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](https://alirezarezvani.com) +- πŸ“ **Blog:** [medium.com/@alirezarezvani](https://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](https://medium.com/@alirezarezvani). + +--- + +## πŸ™ 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](https://alirezarezvani.com) or [blog](https://medium.com/@alirezarezvani) + +### 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** + +