Agent skill
content
Generate authentic, compelling copy for portfolios. Covers tone calibration, taglines, bios, project descriptions, and avoiding assumptions.
Stars
163
Forks
31
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/security/content
SKILL.md
Skill: Content Writing
Generate authentic, compelling copy for portfolios.
Tone Calibration
Based on content.tone in profile.yaml:
| Tone | Style | Example |
|---|---|---|
| professional | Formal, third-person | "Jacob Kieser is a software architect specializing in..." |
| conversational | Casual first-person | "I build tools that make developers' lives easier." |
| technical | Detailed, jargon-appropriate | "Implemented a distributed cache layer using Redis Cluster..." |
| creative | Storytelling, personality | "It started with a broken deploy script at 2am..." |
Length Calibration
Based on content.length:
| Length | Approach |
|---|---|
| concise | Short sentences, bullet points, scannable |
| balanced | Mix of short and long, narrative + lists |
| detailed | Full paragraphs, comprehensive explanations |
Focus Calibration
Based on content.focus:
| Focus | Emphasis |
|---|---|
| projects | What they've built, outcomes, tech choices |
| experience | Roles, companies, career progression |
| skills | Technical depth, certifications, expertise |
| personality | Who they are, how they think, what drives them |
Writing the Tagline
Don't Write
- "Passionate about [X]"
- "Building [vague thing] at scale"
- "Full-stack developer who loves clean code"
- "Turning coffee into code"
Do Write
- Specific value: "Built developer tools used by 2M engineers"
- Unique angle: "Former chef who now designs food tech APIs"
- Clear outcome: "I make AI systems that don't hallucinate"
- Honest and specific: "Infrastructure engineer who deletes more code than I write"
Writing the Bio
Structure
- Hook - Something specific and interesting
- Journey - How they got here (briefly)
- Current - What they're doing now
- Approach - How they think about problems
- Human - Something personal but professional
Anti-Patterns
- "I've been passionate about technology since..."
- Lists of technologies
- "Clean code" and "best practices"
- Corporate jargon (synergize, leverage, thought leader)
Good Examples
- "I spent five years making databases faster at Stripe. Now I help startups avoid the performance mistakes I used to fix."
- "Most of my career has been building tools that other engineers use. I'm good at finding the 80/20."
Writing Project Descriptions
Bad
"A web application built with React and Node.js that allows users to manage tasks."
Good
"Built after realizing Asana was overkill for solo devs. 5K+ developers use it daily to track side projects without the enterprise bloat."
Formula
- Why it exists (the problem)
- What it does (the solution)
- Impact (usage, results, or what you learned)
Critical: Don't Assume or Exaggerate
Never Infer
- Scale from company name ("Engineer at Uber" ≠ "billions of rides")
- Impact without verification
- Metrics you can't confirm
Always Ask
- User counts, revenue, scale
- Specific outcomes
- Role responsibilities
- Why they made certain choices
What You CAN Use
- Technologies from GitHub/package.json
- Public commit history
- Documented project existence
- Dates from public sources
If you're writing numbers without a source, STOP and ask.
Copy Creativity
Based on ai.copy_creativity in profile.yaml:
| Level | Approach |
|---|---|
| 1-3 | Safe, conventional, straightforward |
| 4-6 | Some personality, occasional metaphor |
| 7-8 | Distinctive voice, memorable phrasing |
| 9-10 | Bold, potentially polarizing, very unique |
Section Headers
Avoid Generic
- "About Me"
- "My Projects"
- "Experience"
- "Skills"
Use Specific
- "What I Do"
- "Things I've Built"
- "Where I've Worked"
- "Background"
- Or archetype-specific: "~/about.txt", "PLAYER STATS", "Chapter One"
Didn't find tool you were looking for?