# Skills directory (`skills/`) skills **19 skills** (`SKILL.md` files: `find-skill` as the entry point, plus 18 execution skills) for TiDB external communications — from market intelligence through positioning and messaging to launch, field, and content. ## Credibility These workflows are **not ad-hoc prompts**. They distill patterns from **leading open-source agent/GTM frameworks and industry-grade review practice**, then **tailor them end-to-end for TiDB** — stage gates, artifact handoffs, and a separate knowledge layer so outputs stay consistent as messaging evolves. You can **trust the workflow design**; for TiDB-specific claims, names, and proof points, load **[brain](../brain/README.md)** alongside the relevant skills. **Framework credits** — full table below in [Credits and design provenance](#credits-and-design-provenance). > **Companion directory:** [`brain`](../brain/README.md) — TiDB GTM knowledge concentrate (product, ICP, competitors, messaging, benchmarks). See the [brain README](../brain/README.md) for the Knowledge index. > **Version:** beta v0.10 · [Changelog](CHANGELOG.md) · [Repository](https://github.com/pingcap-inc/tidb-gtm-skills-n-brain) --- ## Credits and design provenance System structure and authoring style build on ideas from the projects below (adapted and TiDB-specific). **Special thanks to Yan Yang ([@yybaroq](https://github.com/yybaroq))** for the branding skill contributions — brand voice guidelines integrated into **`tidb-brand-voice`**, full visual identity system ported into **`tidb-brand-visual`** and **`brain/knowledge/brand.md`** from [`tidb-brand`](https://github.com/yybaroq/tidb-brand). | Source | What we borrowed | Applied to | |--------|------------------|------------| | [`growth-skills`](https://github.com/garrytan/growth-skills) | `SKILL.md` format, content frameworks | All skills | | [`gstack`](https://github.com/garrytan/gstack) | Stage-gate review pattern, artifact handoff chain | Three review-gate skills + overall workflow | | [`gbrain`](https://github.com/garrytan/gbrain) | Brain vs tool separation, knowledge-library shape | Companion brain knowledge layer | | [`pm-skills`](https://github.com/phuryn/pm-skills) | GTM / PMM framing | `tidb-gtm-brief`, `tidb-thought-leadership` | | [`claude-skills`](https://github.com/alirezarezvani/claude-skills) | Skill authoring standards, frontmatter | All `SKILL.md` files | | [`impeccable`](https://github.com/pbakaus/impeccable) | Multi-dimension review design | `tidb-content-review` scoring | | [`agent-gtm-skills`](https://github.com/chadboyda/agent-gtm-skills) | Field / channel GTM playbooks | `tidb-field-brief`, `tidb-competitive-map` | | [`tidb-brand`](https://github.com/yybaroq/tidb-brand) by [@yybaroq](https://github.com/yybaroq) | Complete TiDB visual identity system (colors, typography, logo, Cornerstone, layouts, 74-asset library) | `tidb-brand-visual`, `brain/knowledge/brand.md` | --- ## Quick start > **Workspace rule:** open the repository root (the folder containing both `skills/` and `brain/`) or use `tidb-gtm-pack.code-workspace`. Then follow [INSTALL.md](../INSTALL.md) for setup details. **1. Clone the consolidated repo** ```bash git clone https://github.com/pingcap-inc/tidb-gtm-skills-n-brain.git ``` ``` tidb-gtm-skills-n-brain/ ├── skills/ └── brain/ ``` **2. Load a skill + brain files** (Claude Code / Cursor / Codex — `@` paths, or paste `SKILL.md` into any chat): ``` @skills/find-skill/SKILL.md @brain/knowledge/product.md ``` **3. Pull before a big cycle** ```bash git pull ``` --- ## Skill index | Skill | What it does | |-------|----------------| | [`find-skill`](find-skill/SKILL.md) | **Start here.** Describe your goal → get skill order + brain files. | | [`tidb-brand-voice`](tidb-brand-voice/SKILL.md) | Brand voice, naming, visual standards, banned phrases. | | [`tidb-brand-visual`](tidb-brand-visual/SKILL.md) | Visual identity: colors, typography, logo, Cornerstone, layouts, 74-asset library. | | [`tidb-icp-synthesis`](tidb-icp-synthesis/SKILL.md) | ICP profile from research signals. | | [`tidb-competitive-map`](tidb-competitive-map/SKILL.md) | Competitive positioning map. | | [`tidb-gtm-brief`](tidb-gtm-brief/SKILL.md) | GTM brief: motion, ICP, channels, metrics. | | [`tidb-strategy-review`](tidb-strategy-review/SKILL.md) | Gate on GTM brief. | | [`tidb-product-narrative`](tidb-product-narrative/SKILL.md) | PM → PMM product narrative. | | [`tidb-messaging-platform`](tidb-messaging-platform/SKILL.md) | Full messaging platform. | | [`tidb-benchmark-narrative`](tidb-benchmark-narrative/SKILL.md) | Credible benchmark storytelling. | | [`tidb-messaging-review`](tidb-messaging-review/SKILL.md) | Gate on messaging + benchmarks. | | [`tidb-launch-brief`](tidb-launch-brief/SKILL.md) | Launch execution plan. | | [`tidb-field-brief`](tidb-field-brief/SKILL.md) | Field / event / partner campaigns. | | [`tidb-tech-story`](tidb-tech-story/SKILL.md) | Technical articles & tutorials. | | [`tidb-case-study`](tidb-case-study/SKILL.md) | Customer case studies: intake, structure, SEO/GEO optimization. | | [`tidb-thought-leadership`](tidb-thought-leadership/SKILL.md) | Strategic POV / keynote-style content. | | [`tidb-channel-copy`](tidb-channel-copy/SKILL.md) | Channel-native copy from approved messaging. | | [`tidb-developer-story`](tidb-developer-story/SKILL.md) | OSS / community-facing narratives. | | [`tidb-content-review`](tidb-content-review/SKILL.md) | Final publish gate (8 dimensions). | **By role:** use `find-skill`, or follow the [Workflow map](#workflow-map). GTM Strategy tends toward Stage 0–1; PMM toward Stage 2–4 gates; PM toward `tidb-product-narrative` + review gates; Growth / Field / DevRel toward distribution and content skills in Stage 4. --- ## The skills + brain system ``` skills brain ──────────────────────── ────────────────────────────── HOW — 19 skills (incl. find-skill) Shared GTM reference — knowledge base Stage 0 ICP / competitive Positioning & naming, ICP file Stage 1 GTM brief & review Segments, competitive set Stage 2 Messaging & claims Messaging snapshot, benchmarks Stage 3 Launch / field (same + field context) Stage 4 Content & channels (same) Foundation find-skill + brand …updated on an ongoing basis │ │ └──────── skills load brain ───────┘ @brain/... ``` Skills = workflow logic (stable). Brain = TiDB GTM knowledge (evolving). Details: [brain README](../brain/README.md). --- ## Workflow map ``` Stage 0: Intelligence tidb-icp-synthesis → tidb-competitive-map ↓ Stage 1: Strategy tidb-gtm-brief → [Gate] tidb-strategy-review ↓ Stage 2: Positioning & Messaging tidb-product-narrative → tidb-messaging-platform → tidb-benchmark-narrative → [Gate] tidb-messaging-review ↓ Stage 3: Launch & Campaign tidb-launch-brief → tidb-field-brief ↓ Stage 4: Content & Distribution tidb-tech-story | tidb-case-study | tidb-thought-leadership | tidb-channel-copy | tidb-developer-story → [Gate] tidb-content-review → Publish Foundation: find-skill | tidb-brand-voice | tidb-brand-visual ``` **Gates** (`tidb-strategy-review`, `tidb-messaging-review`, `tidb-content-review`) are blocking until PASS. --- ## Example: PMM path (short) ``` find-skill / tidb-product-narrative + brain/knowledge/product.md → tidb-messaging-platform + icp, competitors, playbooks/messaging.md → tidb-messaging-review → tidb-launch-brief → tidb-tech-story + product.md → tidb-channel-copy → tidb-content-review ``` --- ## Knowledge base (companion layer) File-level index and update cadence: **[brain README — Knowledge index](../brain/README.md#knowledge-index)**. --- ## Maintenance - After each major TiDB release: refresh brain `knowledge/product.md`; audit skills for stale claims. - After each messaging review: refresh `playbooks/messaging.md` in brain. - After approved customer proof: update messaging platform + brain product file as needed. - Quarterly: revisit ICP via `tidb-icp-synthesis` and brain `knowledge/icp.md` if segments shift. --- ## License MIT — see [LICENSE](LICENSE). Skills are workflow logic; adapt freely. Attribution appreciated if you fork for another product.