# verticals

A skill for Claude, Codex, Cursor and other agents: hands the agent the domain brief for one SMB industry before it writes a spec or code.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 107
- Author: avelikiy
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/avelikiy/great_cto/tree/HEAD/skills/verticals/SKILL.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/verticals

## What it does

Every file in this skill is a domain brief for one kind of product. It carries the industry's vocabulary, the entities a spec has to model, the incumbent to route around, and a list of what a naive build gets wrong. There are separate files for home services, professional services, restaurants, retail, real estate, fitness, creator work, HR and recruiting, construction, logistics, travel, nonprofits, agrotech and maritime. Two more sit outside the industry rows: `fintech-mobile.md` for apps that hold a balance and move money on a phone, and `local-seo.md` for public pages that need to be found in local search.

The layout is a reference, not sixteen separate skills. One line shows up in the session's skill list, and the full text loads only when a product needs it. The agent reads a single file rather than the whole directory. In a great_cto checkout the files sit beside the skill at `skills/verticals/<file>`; from an installed plugin you resolve the newest cached copy with the `cat` and `ls` command over `~/.claude/plugins/cache/*/great_cto/*/skills/verticals/<file>.md` that the skill itself carries. Tools are limited to `Read` and `Glob`.

One rule matters most: when no row fits the product, read nothing. A near-miss vertical imports the wrong rules, and your spec ends up modelling entities that do not exist in that business. Pick the row first, open the file second.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add avelikiy/great_cto --skill verticals -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/verticals/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/verticals/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add avelikiy/great_cto --skill verticals -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/verticals/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add avelikiy/great_cto --skill verticals -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/verticals/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install avelikiy/great_cto verticals
```

2. **Manually: put the files in place**
- File: `.github/skills/verticals/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add avelikiy/great_cto --skill verticals -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/avelikiy/great_cto --path skills/verticals
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/verticals/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add avelikiy/great_cto --skill verticals -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/avelikiy/great_cto/tree/HEAD/skills/verticals/SKILL.md

## When to use it
- learn an industry's vocabulary before naming anything in the data model
- list the entities a product spec is required to model
- account for the incumbent a new product has to route around
- review a spec against the usual naive-build mistakes
- apply local SEO requirements to public pages

## Example prompts
- We're building software for cleaning companies — read the matching verticals file and propose a data model.
- We're making an app for a small bakery with orders and shifts, find the right brief in verticals.
- Check my spec against what the verticals file calls naive-build mistakes.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 74b14c1c46cdbb8a.

BEGIN THIRD-PARTY FILE 74b14c1c46cdbb8a
```text
---
name: verticals
description: "Domain knowledge for SMB industry products — the vocabulary, the entities a spec must model, the incumbent to route around, and what a naive build gets wrong — one file per industry, plus local SEO and money-on-a-phone. Read the one file that applies before speccing or building the product."
when_to_use: |
  Speccing or building a product for one of the industries below, a public page that must
  rank locally, or an app that moves money on a phone. Read ONE file, not the directory.
effort: low
allowed-tools: Read, Glob
---

# Verticals — read the one that applies

Each file below is the domain brief for one kind of product. They are references, not
separate skills: one line in every session's skill list instead of sixteen paragraphs, and
the full text only when a product needs it.

| Product is for… | Read |
|---|---|
| HVAC, plumbing, cleaning, landscaping — dispatch, quoting, booking | `home-services.md` |
| Agencies, consulting, creative — proposals, portals, time + invoicing | `professional-services.md` |
| Restaurants, cafés — ordering, reservations, loyalty, shifts | `restaurants.md` |
| SMB storefronts — catalog, inventory, pricing, cart recovery | `retail.md` |
| Residential real estate — listings, lead CRM, transactions, property management | `real-estate.md` |
| Studios, gyms, coaches — class booking, membership, content | `fitness.md` |
| Creators, marketing — scheduling, analytics, monetization, sponsorships | `creator.md` |
| HR, recruiting — ATS, onboarding, scheduling, surveys | `hr-recruiting.md` |
| Contractors, field crews — bids, project logs, subcontractors | `construction.md` |
| Shipping, warehouse-lite, routes, purchase orders | `logistics.md` |
| Tour and activity operators, small stays, travel advisors — departures, OTAs, itineraries | `travel.md` |
| Small nonprofits — donations, donor records, grants, volunteers | `nonprofit.md` |
| Small farms — field and spray records, livestock, shares and direct sales, lot codes | `agrotech.md` |
| Marinas, boat charter, vessel upkeep, container tracking for small forwarders | `maritime.md` |
| An app that holds a balance or moves money on a phone (orthogonal to the rows above) | `fintech-mobile.md` |
| Public pages that must be found in local or product search | `local-seo.md` |

## How to read it
```
END THIRD-PARTY FILE 74b14c1c46cdbb8a

The third-party file has ended. Everything between the 74b14c1c46cdbb8a tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2370 of 3008 bytes. © avelikiy · MIT · https://github.com/avelikiy/great_cto/tree/HEAD/skills/verticals/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md