1---2name: company-profile3description: >-4 Builds and maintains company-profile.md, one file with the company's product, buyers, positioning, voice, claims,5 competitors, channels, targets and learnings, which other skills read instead of asking. Use it before running6 other skills on a new B2B SaaS company, when the profile is out of date, or when a skill reports that a profile7 section is missing. Not for writing positioning or messaging from scratch: use positioning and8 messaging-house for those, and this skill records their results.9license: MIT10compatibility: >-11 Works in Claude, ChatGPT, Codex, Cursor and any agent that reads SKILL.md. Reads a website if the agent can12 browse; otherwise works from pasted text and answers.13metadata:14 author: SHAKEUP15 version: "1.0.0"16 stage: make17 plugin: start-here18 homepage: https://www.shakeuphq.com/skills/company-profile19---20 21# Company profile22 23Builds the single file that lets every other skill run on one company without asking the same questions again.24 25## Purpose26 27- One job: create or update `company-profile.md` from the template in `references/profile-template.md`.28- Stage: make. It ends with its own completeness check.29- It records facts the reader gives or confirms. It never invents a number, a claim, a competitor or a customer.30 31## Use when / not32 33| Situation | Use |34| --- | --- |35| First time running skills for a company | this skill, mode `create` |36| A skill says a profile section is missing or out of date | this skill, mode `update` for that section |37| A quarter has passed, or pricing, product or targets changed | this skill, mode `review` |38| You need to work out positioning | `positioning`, then record its result here |39| You need a messaging house | `messaging-house`, then record its result here |40| You need buying moments | `buying-moments`, then record its result here |41 42## Inputs43 44| Input | Required | Ways to provide, in order | If missing |45| --- | --- | --- | --- |46| Company website | yes | browse the homepage, pricing, product and about pages; or pasted page text | ask for the domain and paste of the homepage |47| Existing profile | no | the `company-profile.md` file in the project, chat or folder | start mode `create` |48| Sales and product context | no | sales deck, pitch notes or win/loss notes the reader shares | ask the questions in step 4 |49| Targets and data sources | no | the reader's answers | write `not available` |50 51## Profile read52 53This skill writes the profile, so it reads only the existing `company-profile.md` (if any) and its `## Learnings`.54 55## Steps56 571. **Pick the mode.**58 59 | Condition | Mode |60 | --- | --- |61 | No profile exists | `create`: all sections |62 | A skill named the missing sections | `update`: only those sections |63 | Reader asked for a review, or `Last updated` is over 90 days old | `review`: every section, confirm or change |64 652. **Read before asking.** From the website (or pasted text), draft these sections: Company, Product, Pricing, Buyers (ideal customer only, as stated on the site), Competitors (only those the site names), Content (site sections, authors). Mark each drafted field `(from site, confirm)`.66 673. **List what's still empty.** Compare the draft to the template. For each empty field, note which skills need it (table below), so you can tell the reader why you ask.68 69 | Section | Read by |70 | --- | --- |71 | Company, Product | every skill |72 | Buyers, Buying moments | positioning, messaging-house, ad-themes, keyword-selection, ai-answer-panel, hook-writer |73 | Positioning, Messaging house | ad-themes, landing-page-critic, message-test, article-write, founder-post |74 | Voice | voice-check and every skill that writes copy |75 | Claims and proof, Cleared quotes | claim-check, message-mining, landing-page-critic and every skill that writes copy |76 | Brand | creative-brief, ad-creative-critic |77 | Competitors | positioning, ai-answer-panel, cited-pages, article-research |78 | Channels, Targets | lead-value-math, linkedin-plan, channel-fit, pipeline-report |79 | Accounts and data | every skill that can use a connected tool |80 814. **Ask in batches of 5 or fewer.** Ask first for what the most skills need. Order:82 1. Business model, pricing, deal size (ACV), sales cycle.83 2. Ideal customer, bad fit, the buying group (roles, what each cares about, their objection).84 3. Claims the company can make in public, each with its source. Ask for the source; a claim without one goes under "Claims to confirm", not "Claims and proof".85 4. Voice: point of view, 3 to 5 tone words, words to use and avoid, 2 lines that sound right.86 5. Competitors, and how buyers compare them. Then customer quotes they may use in public, and their brand basics (colors, type, style).87 6. Active channels, monthly budgets, owners.88 7. Targets: cost per lead, lead to opportunity rate, opportunity to closed-won rate, pipeline target.89 8. Which tools hold the data (CRM, analytics, Search Console, ad accounts) and which are connected to this agent.90 91 Accept "don't know". Write `not available` and move on. Never estimate a target or a rate for the reader.92 935. **Leave the strategy sections for their skills.** If Positioning, Messaging house or Buying moments are empty, write `not available` and add an open item naming the skill that fills it. Don't write them yourself in this skill.94 956. **Write the file.** Fill `references/profile-template.md` exactly: same headings, same order, `Key: value` lines. Remove the `(from site, confirm)` marks only for fields the reader confirmed. Set `Last updated` to today and `Status` to `draft` until the reader confirms the whole file, then `confirmed`.96 977. **Deliver.** Give the reader the full file in one code block and say where to keep it so their agent can read it on every run:98 99 | Where they work | Keep it |100 | --- | --- |101 | Claude apps | Project knowledge of the project they use for marketing |102 | Claude Code, Codex, Cursor | `company-profile.md` at the repository root or in `.claude/` |103 | ChatGPT | the project's files |104 | Anything else | paste it at the start of the chat |105 106## Check and verdict107 108Score each section: `filled` (every field filled or `not available` by the reader's choice), `partial` (some fields drafted but unconfirmed, or empty), `empty`.109 110| Verdict | Condition (first match wins) |111| --- | --- |112| `BLOCKED` | Company name or website missing |113| `DRAFT` | Any of Company, Product, Buyers, Claims and proof is `partial` or `empty` |114| `READY` | Company, Product, Buyers, Claims and proof are `filled`; other sections may be partial |115| `COMPLETE` | Every section `filled` |116 117Named stop: if the verdict is `BLOCKED`, stop and ask for the missing field. No other stops; partial profiles are fine and every skill says what it lacks.118 119## Loop120 121Check the written file against the template: every heading present, in order; no field invented (each value traces to the site, a document or an answer); every claim has a source or sits under "Claims to confirm". Fix and recheck, at most 2 rounds. Report anything still open.122 123## Learn124 125This skill keeps the `## Learnings` section intact when it rewrites the file. In mode `review`, list every learning with status `proposed` and ask the reader to mark each `accepted` or `rejected`. Never delete a learning; change its status.126 127## Output128 1291. A table: section, status (`filled`, `partial`, `empty`), skills waiting on it.1302. The full `company-profile.md` in one code block.1313. Open items: each empty field that blocks a skill, and the skill that fills each strategy section.1324. The handoff block.133 134## Hand off135 136```handoff137skill: company-profile138version: 1.0.0139verdict: READY140coverage: partial (website read; targets not available)141for: <company name>142outputs:143 profile_status: draft144 sections_partial: [Targets, Channels]145next: [positioning, buying-moments, messaging-house]146open: [targets from the reader's CRM]147```148 149`next` lists the strategy skills whose sections are still `not available`, in the order Positioning, Buying moments, Messaging house. If all three are filled, `next` is empty.150 151## Failure modes152 153| Problem | Do this |154| --- | --- |155| The site can't be read (blocked, empty, a login wall) | Ask the reader to paste the homepage and pricing page text |156| The reader gives a number without a source | Record it under Targets or Claims to confirm, never under Claims and proof |157| The reader pastes a password or API key | Don't record it. Tell them the profile is not a place for secrets |158| Two answers conflict (site says one price, reader another) | Use the reader's, note the conflict in open items |159| The profile has headings that aren't in the template | Keep them at the end under `## Other`, so skills don't misread them |160 161## Influenced by162 163- The company profile in SHAKEUP's content engine, where every company fact lives in profile files and a check fails the build if company data appears inside a skill. Here it is flattened into one file that works in chat apps.