AISkills/README.md

# Soroush's Claude Skills

Personal collection of Claude Code skills — custom-built and curated.
Install any skill by copying its folder into `~/.claude/skills/`.

---

## 🔧 Custom Skills (built for this setup)

| Skill | Description |
|---|---|
| [soroush-cicd](./soroush-cicd/SKILL.md) | CI/CD pipeline method using self-hosted Gitea + Nexus mirror. Covers workflow design, Docker deploy patterns, port safety, DB backup before deploy, rollback tagging, and lessons from real production incidents on draletaha.ir. Trigger: "my ci/cd method", "add CI/CD", "deploy to gitea". |
| [flat-artist](./flat-artist/SKILL.md) | **Master entry point** for creating FlatRender video templates with Remotion + Three.js — a professional motion-design pipeline to a Renderforest/AE bar. **Bundles the whole template-creation suite inside its folder**: 16 sub-skills (`flat-artist/<name>/SKILL.md`) — design-styles, character-design, aspect-ratios, template-composition, sound-effects, music-picker, template-catalog, svg-colors, persian-fonts, flatrender-template-seo, motion-design-principles, scene-transitions, kinetic-typography, video-hooks, particles-and-effects, asset-sourcing — plus a design/motion R&D report (`flat-artist/references/design-motion-rnd.md`). Persian-first. Trigger: "Flat Artist", "start/design a flatrender template". |

---

## 🌐 Browser & Automation

| Skill | Trigger | Description |
|---|---|---|
| `agent-browser` | "open website", "click button", "take screenshot", "scrape data" | Browser automation via Chrome CDP — navigate, fill forms, screenshot, extract data, test web apps, automate Electron apps (VS Code, Slack, Figma). |
| `playwright-cli` | "playwright test", "automate browser" | Automate browser interactions and work with Playwright tests. |
| `automation-workflows` | "automate this", "build a workflow" | General automation workflow builder. |

---

## 🚀 CI/CD & Development

| Skill | Trigger | Description |
|---|---|---|
| `soroush-cicd` | "my ci/cd method", "soroush pipeline", "set up gitea", "deploy" | Full CI/CD setup with Gitea Actions + Nexus. Includes production safety rules learned from real incidents. |
| `microservices-patterns` | "microservices", "service boundaries", "event-driven" | Design microservices architectures with service boundaries, event-driven communication, and resilience patterns. |
| `mcp-builder` | "build MCP", "create MCP server" | Guide for creating high-quality MCP servers that enable LLMs to interact with external services. |
| `refactoring` | "refactor", "clean up code", "improve structure" | Refactoring assessment and patterns. |
| `requesting-code-review` | "review my code", "before merging" | Pre-merge code review checklist. |
| `spec-writer` | "write spec", "CSI spec", "MasterFormat" | CSI outline specification writer — structured specs with MasterFormat divisions. |

---

## 📊 Business & Strategy

| Skill | Trigger | Description |
|---|---|---|
| `competitive-analysis` | "analyze competitors", "competitive landscape" | Competitive analysis framework. |
| `decision-frameworks` | "help me decide", "decision matrix" | Structured decision-making frameworks. |
| `delegation-framework` | "delegate tasks", "team delegation" | Delegation planning and framework. |
| `financial-modeling` | "financial model", "revenue forecast", "P&L" | Financial modeling and forecasting. |
| `founder-productivity` | "productivity system", "founder workflow" | Productivity systems for founders. |
| `fundraising` | "raise money", "pitch investors", "funding round" | Fundraising strategy and materials. |
| `hiring-playbook` | "hire", "job description", "interview process" | End-to-end hiring playbook. |
| `market-research` | "market research", "TAM", "market size" | Market research and analysis. |
| `pitch-deck` | "pitch deck", "investor presentation" | Pitch deck builder. |
| `pricing-strategy` | "pricing", "price my product", "pricing model" | Pricing strategy frameworks. |
| `product-market-fit` | "PMF", "product-market fit", "validate idea" | Product-market fit assessment. |
| `team-building` | "build my team", "team structure", "org chart" | Team building and organizational design. |
| `unit-economics` | "unit economics", "CAC", "LTV", "margins" | Unit economics calculator and analysis. |

---

## 📝 Content & Marketing

| Skill | Trigger | Description |
|---|---|---|
| `cold-outreach` | "cold email", "outreach sequence", "sales email" | Cold outreach sequence builder. |
| `copywriting` | "write copy", "sales copy", "landing page copy" | Conversion copywriting. |
| `email-campaigns` | "email campaign", "newsletter", "drip sequence" | Email campaign builder. |
| `landing-pages` | "landing page", "build landing page" | Landing page builder. |
| `MetaAds` | "Meta ads", "Facebook ads", "Instagram ads" | Meta Media Buyer — publish, manage, and analyze Meta ad campaigns via the Marketing API. |
| `objection-handling` | "handle objections", "sales objections" | Sales objection handling frameworks. |
| `offer-creation` | "create offer", "irresistible offer" | Offer creation and positioning. |
| `paid-ads` | "Google ads", "paid advertising", "PPC" | Paid ad campaign builder — Google Search Ads, headlines, descriptions, A/B variants. |
| `seo-content` | "SEO article", "write for SEO", "blog post" | SEO-optimized content writer. |
| `social-media` | "social media post", "Instagram caption", "tweet" | Social media content creator. |
| `sop-builder` | "SOP", "standard operating procedure", "process doc" | Standard operating procedure builder. |

---

## 🎨 Design & Visual

| Skill | Trigger | Description |
|---|---|---|
| `color-palette-generator` | "color palette", "brand colors", "color scheme" | Creates harmonious color palettes from descriptions, moods, or images. Outputs HTML with swatches, hex/RGB/HSL codes, and contrast ratios. |
| `graphify` | "knowledge graph", "visualize relationships", "map this codebase" | Converts any input (code, docs, papers, images) to a knowledge graph. |
| `resize-images` | "resize images", "batch resize", "optimize images for web" | Batch-resize images for web (WebP 1920/1200/400px), social (Instagram, Twitter), and print. |
| `slide-deck-generator` | "slide deck", "presentation", "slides" | Generates a polished HTML slide deck from a topic, outline, or data. |
| `studio` | "what skill should I use?", "route my task" | Smart router — describes your task and routes you to the right skill. |

---

## 🛒 Product & FF&E

| Skill | Trigger | Description |
|---|---|---|
| `csv-to-sif` | "convert to SIF", "FF&E to SIF" | Convert a CSV or Excel FF&E product list to SIF (Standard Interchange Format) for dealer and procurement systems. |
| `sif-to-csv` | "SIF to CSV", "convert SIF file" | Convert a SIF file to a clean, readable CSV or Google Sheet. |
| `product-data-cleanup` | "clean FF&E data", "normalize product list" | Clean up an FF&E schedule — normalize casing, dimensions, units, language, and formatting. |
| `product-data-import` | "import products", "FF&E schedule from notes" | Generate a formatted FF&E specification schedule from raw product data. |
| `product-enrich` | "tag products", "categorize FF&E" | Auto-tag FF&E products with categories, colors, materials, and style tags. |
| `product-image-processor` | "process product images", "remove background" | Download, resize, and remove backgrounds from product images at scale. |
| `product-match` | "find similar product", "match this item" | Find visually or functionally similar products from an image, name, or description. |
| `product-pair` | "what goes with this?", "complementary products" | Suggest complementary products that pair well with a given item. |
| `product-research` | "find products for brief", "FF&E research" | FF&E product research — searches the web for matching products from a designer brief. |
| `product-spec-bulk-fetch` | "fetch product specs", "bulk spec URLs" | Fetch structured FF&E product specs from a list of URLs. |
| `product-spec-pdf-parser` | "parse product PDF", "extract specs from PDF" | Extract structured FF&E product specs from PDF files — price books, fact sheets. |

---

## 🏗️ Architecture & Urban Planning (NYC)

| Skill | Trigger | Description |
|---|---|---|
| `demographics-analysis` | "demographics", "population data", "income data" | Demographics and market site analysis — population, income, age, housing market, employment data from an address. |
| `environmental-analysis` | "climate analysis", "flood zone", "sun angles" | Climate and environmental site analysis — temperature, precipitation, wind, flood zones, seismic risk, soil. |
| `history` | "neighborhood history", "architectural character" | Neighborhood context and history — adjacent uses, landmarks, commercial activity, planned development. |
| `mobility-analysis` | "transit access", "walk score", "subway nearby" | Transit and mobility site analysis — subway, bus, bike, pedestrian infrastructure, walk scores. |
| `nyc-acris` | "ACRIS", "deed lookup", "NYC mortgage records" | Look up ACRIS property transaction records — deeds, mortgages, liens. |
| `nyc-bsa` | "BSA variance", "special permit NYC" | Look up BSA variances and special permits for any NYC property. |
| `nyc-dob-permits` | "DOB permits", "building permits NYC" | Look up DOB permit and job filing history for any NYC building. |
| `nyc-dob-violations` | "DOB violations", "ECB violations NYC" | Look up DOB and ECB violations for any NYC building. |
| `nyc-hpd` | "HPD violations", "housing violations NYC" | Look up HPD violations, complaints, and building registration for residential buildings. |
| `nyc-landmarks` | "landmarked building", "historic district NYC" | Check if a NYC building is landmarked or in a historic district using LPC data. |
| `nyc-property-report` | "full property report NYC", "property research NYC" | Combined NYC property report — landmarks, DOB permits, violations, ACRIS records, HPD, BSA variances. |
| `occupancy-calculator` | "occupancy load", "IBC occupancy", "max occupants" | IBC occupancy load calculator — calculates maximum occupant loads per area from IBC Table 1004.5. |
| `workplace-programmer` | "office program", "workplace strategy", "space program" | AI workplace strategy consultant — builds office space programs through conversation. |
| `zoning-analysis-nyc` | "NYC zoning", "FAR", "zoning envelope" | Analyze zoning envelope rules for lots in New York City using PLUTO data. |
| `zoning-envelope` | "3D zoning envelope", "visualize zoning" | Generate interactive 3D zoning envelope viewers from zoning analysis reports. |

---

## 🌿 Environmental & Sustainability

| Skill | Trigger | Description |
|---|---|---|
| `epd-compare` | "compare EPDs", "environmental impact comparison" | Compare 2+ products side-by-side on environmental impact metrics. Normalizes declared units, checks system boundary alignment, LEED MRc2 compliance. |
| `epd-parser` | "parse EPD", "extract EPD data", "EPD PDF" | Parse EPD (Environmental Product Declaration) PDF documents to extract structured environmental impact data — GWP, life cycle stages, certifications. |
| `epd-research` | "find EPDs", "search EPD database", "EC3 EPD" | Search for EPDs by product category, CSI division, or material type from EC3 and program operator registries. |
| `epd-to-spec` | "EPD spec section", "write EPD specification" | Generate CSI-formatted specification sections requiring EPDs and setting maximum GWP thresholds. |

---

## 🛠️ Utilities

| Skill | Trigger | Description |
|---|---|---|
| `find-skills` | "find a skill", "is there a skill for X" | Helps discover and install agent skills for any task. |
| `master-schedule` | "master schedule", "project schedule" | Project master schedule builder. |
| `skills-menu` | "what skills do you have?", "show skills" | Show all available skills organized by task. |

---

## Installing a skill

```bash
# Copy any skill folder to your Claude skills directory
cp -r ./soroush-cicd ~/.claude/skills/

# Or on Windows
xcopy /E /I soroush-cicd "%USERPROFILE%\.claude\skills\soroush-cicd"
```

Then restart Claude Code — the skill is immediately available.