profile-optimization — Claude Code skill: guide and install
Turns social media profiles into conversion landing pages. Optimizes bios, searchable handles, link placement, and banner specs for clarity.
npx skills add social-media-skills/skills --skill profile-optimization -a claude-codeWhat profile-optimization does
Accounts often lose visitors because their bio tries to be clever instead of clear. This skill treats an account like a landing page: visitors must grasp who you help, what you do, and why they should follow within three seconds. It reads brand-profile.md, social-strategy.md, audience.md, and voice.md before drafting any copy.
The skill delivers a copy-paste spec tailored per platform, covering searchable keywords for name fields, one primary CTA, and briefs for banners and pinned posts. It remains strictly advisory. WoopSocial publishes posts but cannot update profile fields directly, so you apply the generated changes manually.
What it helps with
- rewrite a vague social bio into a clear value proposition
- inject searchable niche keywords into name and headline fields
- brief visual banners and pinned posts to retain new visitors
- narrow down multiple conflicting bio links to one primary goal
Example prompts for the agent
- Optimize my LinkedIn profile headline and bio for inbound leads
- Audit my Instagram profile using the 3-second clarity test
- Create a per-platform profile spec for TikTok and YouTube
How to install profile-optimization
1Skills CLI (Vercel)
npx skills add social-media-skills/skills --skill profile-optimization -a claude-code2Manually: put the files in place
~/.claude/skills/profile-optimization/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/profile-optimization/
1Skills CLI (Vercel)
npx skills add social-media-skills/skills --skill profile-optimization -a codex2Manually: put the files in place
.agents/skills/profile-optimization/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add social-media-skills/skills --skill profile-optimization -a cursor2Manually: put the files in place
.cursor/skills/profile-optimization/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install social-media-skills/skills profile-optimization2Manually: put the files in place
.github/skills/profile-optimization/SKILL.md1Skills CLI (Vercel)
npx skills add social-media-skills/skills --skill profile-optimization -a gemini-cli2Platform CLI
gemini skills install https://github.com/social-media-skills/skills --path skills/profile-optimizationManually: put the files in place
.devin/skills/profile-optimization/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add social-media-skills/skills --skill profile-optimization -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about profile-optimization
How do I install profile-optimization in Claude Code?
Run npx skills add social-media-skills/skills --skill profile-optimization -a claude-code. The skill file will be stored at ~/.claude/skills/profile-optimization/SKILL.md.
Can this skill update my social accounts directly?
No. It operates in an advisory mode and outputs ready-to-paste text. WoopSocial schedules media but cannot modify account settings or bio fields.
What foundation files does the skill require?
It pulls context from brand-profile.md, social-strategy.md, audience.md, and voice.md. These files provide your positioning, audience tone, and target goals.
Source text
SKILL.md · MIT
---
name: profile-optimization
description: >-
Use to optimize a social media profile so it converts visitors into followers and followers into
leads — bio, handle, name/headline field, profile picture, banner/header, link-in-bio, CTA, pinned
posts, and highlights. Run when the user says "optimize my profile/bio," "write my bio," "my
Instagram/LinkedIn/TikTok bio," "profile," "link in bio," "my profile isn't converting," asks
about creator mode or a professional/business account, or wants their account to convert better.
Reads brand-profile, voice, audience, and social-strategy first. Treats the profile as a
conversion landing page — 3-second clarity, searchable-field keywords, a who/what/why bio with one
CTA, a goal-matched link, and specs for the visuals, pinned posts, and highlights. Advisory:
produces a ready-to-apply per-platform spec (WoopSocial publishes posts/media; it does not edit
profile fields). Judges results via native profile insights, not WoopSocial analytics.
metadata:
version: 1.0.0
license: MIT
---
# Profile Optimization
Your profile is a **conversion landing page, not decoration.** Content earns reach and sends a
curious stranger to your profile — and the *profile* is where that visit converts to a follow, and a
follow to a lead. Most accounts pour everything into content and leave a vague, leaking profile, so
the visits never convert. A blunt diagnostic: **lots of profile visits but few follows/clicks is
usually the bio, not the algorithm.**
Two commitments:
1. **Clarity beats cleverness.** A visitor decides in seconds. Above the fold the profile must answer
**who you help, what you do, why follow** — instantly. A witty-but-vague bio converts worse than a
plain, specific one.
2. **Every element has a job.** The name field is *searchable*. The link is the *conversion
mechanism*. The banner is *prime real estate*. "Filled in" isn't optimized.
> Scope: this skill is **advisory** — it produces a ready-to-apply spec. **WoopSocial publishes posts
> and media; it does not edit profile fields**, so the user applies the spec in each app.
## Step 0 — Read the foundation
Load `brand-profile.md`, `social-strategy.md`, `audience.md`, `voice.md`. The profile is positioning
made concrete: who you help + the wedge (brand/strategy), the audience's language (audience), the
primary goal → the CTA/link (strategy), and the tone (voice).
## Step 1 — Run the funnel + the 3-second test
Diagnose the profile as a funnel — **Discovered → Clarity → Follow → Convert** — and find which stage
leaks (unfindable / unclear / unconvincing / dead-end). Make sure the above-the-fold answers
who/what/why at a glance. Niche down — **"for everyone" converts no one.** See
`references/the-profile-funnel.md`.
## Step 2 — Exploit the searchable fields (get discovered)
Put a **niche keyword** in the searchable fields — the **Instagram name field**, the **LinkedIn
headline**, the **YouTube description** — not just your name or "Founder." Think like your audience:
what would they search? Keep the handle searchable and consistent. See `references/element-playbook.md`.
## Step 3 — Write the bio (earn the follow)
Who you help · what you do · **proof** (real only) · **CTA + link prompt** — clarity first,
personality second, skimmable, within the limit, on-voice. See `references/element-playbook.md`.
## Step 4 — The link + CTA (convert)
**Match the link to the current goal** (one clear destination beats a 15-link junk drawer; if you
need a hub, lead with the priority action). Pick **one** primary CTA. Make the bio say *why* to click.
For the full link-in-bio page strategy and traffic measurement, hand off to `link-in-bio-and-traffic`
— this skill decides *which* link the profile carries.
## Step 5 — The visual + first impression
Profile **picture** (face for personal brands, clean logo for companies; recognizable at thumbnail).
**Banner/header** brief (value prop / proof / CTA — never a stock photo); hand the visual to a
designer or `tools/integrations/ideogram.md` (legible text). **Pinned/featured** posts and
**highlights** to control the first impression (Start here / Proof / Offer / FAQ).
## Step 6 — Per-platform spec + consistency
Produce a **ready-to-paste spec per platform** (handle, name field, bio, link, CTA, pinned plan,
highlights, banner brief), each passing the 3-second test. Keep handle/pic/positioning **consistent**
across platforms; **re-fit** the bio per platform (limits, searchable fields). See
`references/platform-specs.md`.
## Quality bar — self-check
- Does it pass the **3-second test** (who/what/why above the fold)?
- Are the **searchable fields** used for keywords (name field / headline)?
- Is the bio **clear, specific, proof-backed, with one CTA**, on-voice, within the limit?
- Is the **link matched to the goal** (not a junk drawer)?
- Are **pinned/highlights/banner** specced (not left default/stock)?
- Is it **niched** (not "for everyone")?
- Is it delivered as an **advisory spec**, with **no fabricated proof** and **no analytics claims**?
## Edge cases & pushback
- **Vague/clever bio** ("dream big ✨") → rewrite for who/what/why clarity.
- **Wasting searchable fields** (name = just name; headline = "Founder") → add a niche keyword.
- **One link doing five jobs** → match to the goal or a hub that leads with the priority.
- **"Appeal to everyone"** → niche down; for-everyone converts no one.
- **Stock-photo banner** → a banner brief carrying value prop/proof/CTA.
- **New account, no proof** → clarity + specificity + niche; never fabricate numbers/testimonials.
- **"Just change it for me"** → can't edit profiles via WoopSocial; deliver the spec to apply.
- **"Which bio performs best?"** → native profile insights / the 3-second test; no WoopSocial
analytics.
## Related skills
- `brand-profile`, `social-strategy`, `audience-research`, `voice-builder` — the positioning the
profile makes concrete.
- `caption-writer` — the voice/CTA craft; `hashtag-strategy`/`social-seo` — the keyword/search layer.
- `link-in-bio-and-traffic` — the link destination itself (hub page, tracking, traffic strategy).
- `*-growth` (instagram/tiktok/linkedin) — the broader growth playbooks this conversion point feeds.
- `tools/integrations/ideogram.md`, `nano-banana.md` — generate the banner/profile visuals.
## References
- `references/the-profile-funnel.md` — profile as landing page, the 3-second test, the funnel, niche.
- `references/element-playbook.md` — each element's job + how to optimize it (bio formula, link, banner…).
- `references/platform-specs.md` — per-platform fields, limits, searchable surfaces, priority moves.
- `references/examples.md` — worked specs with before/after, across IG / LinkedIn / TikTok.
© social-media-skills · MIT · social-media-skills/skills