Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/joellewis/skill-library --skill character-vulnerability- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads character-vulnerability automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Overview
Character vulnerability is the art of exposing the "hidden self." It moves beyond characterization (the observable mask) to reveal true character through choices made under pressure. By identifying a character’s "Sacred Flaw" (Storr) and testing their "Theory of Control" through the "Three Sliders" (Sanderson), the writer creates empathetic, three-dimensional individuals that the audience identifies with.
Guiding Principles
Principle 1: Character is Revelation (Source: McKee, Story)
True character is revealed in the choices a human being makes under pressure. The greater the pressure, the deeper the revelation. A character who seems strong but breaks under pressure reveals their true nature; a character who seems weak but acts heroically under fire reveals theirs.
Principle 2: The Sacred Flaw (Source: Storr, Science of Storytelling)
Vulnerability is rooted in the "Sacred Flaw"—a character's fundamental misbelief about the world. This misbelief usually formed as a survival mechanism (Theory of Control). The character cling to this flaw because they believe it keeps them safe, but the plot must systematically strip this protection away.
Principle 3: Characterization is the Mask (Source: McKee, Story)
Characterization is the sum of all observable traits: age, IQ, style of speech, clothing, and environment. These traits must be used to contrast or contradict the true character. Dimensions are created in the gap between who a character pretends to be and who they are when they choose under fire.
Principle 4: The Emotional Acre (Source: Lamott, Bird by Bird)
Every character has an "emotional acre" they tend. Some acres are pristine and alphabetized; others are auto-wrecking yards. Show the character tending their acre to define what they value and what they are trying to hide from the world.
Principle 5: The Three Sliders (Source: Sanderson, character lectures)
Adjust the sympathy of a character using three levers:
- Likability: How much we want to be their friend.
- Competence: How good they are at their job or skill.
- Proactivity: How much they act to change their circumstances. Vulnerability is often created by dialing one slider low (e.g., low competence) while they struggle with high proactivity.
When to Use This Skill
- Creating a protagonist that an audience will "root for."
- Designing complex antagonists who believe they are the hero.
- Deepening a character's internal struggle (want vs. need).
- Drafting character "backstory" or internal monologues.
When NOT to Use This Skill
- Developing minor "functional" characters (e.g., the shopkeeper) who don't need dimension.
- Creating archetypal "Force of Nature" villains (e.g., Sauron) who are symbols rather than people.
Core Process
Step 1: Define the Theory of Control (Source: Storr)
Ask: "How did this character learn to survive their childhood?"
- What is their default tactic when things go wrong? (e.g., Aggression, Sarcasm, Hiding, Controlling others).
- This tactic is the "Sacred Flaw" they must eventually abandon.
Step 2: Dial the OCEAN Traits (Source: Storr)
Establish consistency by setting the character's Big Five personality levels:
- Openness: Curious vs. Cautious.
- Conscientiousness: Disciplined vs. Careless.
- Extraversion: Outgoing vs. Solitary.
- Agreeableness: Trusting vs. Suspicious.
- Neuroticism: Anxious vs. Confident.
Step 3: Create Identity Residue (Source: Storr)
Show, don't tell, the character's traits through their environment. What do they broadcast to others (Identity Claims)? What do they leave behind accidentally (Behavioural Residue)? Contrast a "perfect" office with a "secret" desk drawer full of empty bottles.
Step 4: The Choice Under Pressure (Source: McKee)
Place the character in a dilemma where they must choose between two irreconcilable goods or the lesser of two evils.
- A choice between "Right and Wrong" is trivial.
- A choice between "Saving your skin or Saving your friend" is a revelation.
Step 5: The Vonnegut Shape (Source: Vonnegut)
Map the character's emotional arc of fortune. Is it a "Man in Hole" (rise, fall, rise)? Every "drop" in fortune is an opportunity to reveal a new layer of character vulnerability and resilience.
Frameworks & Models
The Hero-Maker Narrative (Source: Storr, Science of Storytelling)
Characters (even villains) see themselves as the moral hero.
- The Intent: Why do they believe their actions are justified?
- The David vs. Goliath Bias: Who is the "Goliath" they believe they are fighting?
- The Self-Justification: How does their brain rewrite their past to excuse their current flaws?
The Revelation Gap (Source: McKee, Story)
- Level 1 (Mask): The observable characterization.
- Level 2 (The Secret): The hidden nature the character tries to protect.
- Level 3 (True Character): The choice they make when Level 1 and Level 2 are stripped away by pressure.
Cross-Skill Invocations
REQUIRED SUB-SKILL: fiction-architect — to ensure the plot applies the necessary pressure. RECOMMENDED SUB-SKILL: rapport-builder — to translate these fictional insights into real-world interpersonal influence.
Common Mistakes
- The Perfect Hero: Making a character too competent and likable, leaving them with no "Sacred Flaw" to overcome. (Source: Sanderson)
- Backstory Dumping: Telling the character's history in prose instead of revealing it through choice and action. (Source: McKee)
- Inconsistent Voice: Dialing the personality traits differently in each scene, making the "self" feel fragmented and unreal. (Source: Storr)
Diagnostic Checklist
- Has the character's "Sacred Flaw" been identified?
- Is there a contradiction between the character's appearance and their inner nature?
- Does the character make a high-stakes choice that reveals their core values?
- Have I used "Behavioural Residue" to show personality?
- Is the character's "Theory of Control" challenged by the plot?
Sources
- Storr, Will. The Science of Storytelling. Ch. 2 (The Flawed Self), Ch. 2.6 (Hero-Maker Narrative).
- McKee, Robert. Story. Ch. 5 (Structure and Character), Ch. 17 (Character).
- Lamott, Anne. Bird by Bird. "Character," "Emotional Acre."
- Sanderson, Brandon. "The Three Sliders" (Writing Lectures).
- Vonnegut, Kurt. "Shapes of Stories".
FAQ
What does the character-vulnerability skill do?
Use when a character feels flat, too competent, or unrelatable—identifies the Sacred Flaw (Storr's Theory of Control) and dials the Three Sliders (Sanderson) to create earned vulnerability.
How do I install character-vulnerability?
Run npx skills add https://github.com/joellewis/skill-library --skill character-vulnerability in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/character-vulnerability/ (personal) or .claude/skills/character-vulnerability/ (project).
Which AI agents can use character-vulnerability?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is character-vulnerability safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains character-vulnerability?
It is published by joellewis in joellewis/skill-library. It has 47 recorded installs.
More from joellewis/skill-library
fiction-architect
joellewis/skill-library
Open the skill to read its SKILL.md instructions.
world-building-logic
joellewis/skill-library
Open the skill to read its SKILL.md instructions.
problem-framing
joellewis/skill-library
Use when beginning analytical or strategic tasks, facing undefined problems, or facing analysis paralysis—requires explicit problem definition before proceeding.
non-fiction-precision
joellewis/skill-library
Open the skill to read its SKILL.md instructions.
Popular security skills
azure-compliance
microsoft/azure-skills
Run Azure compliance and security audits with azqr plus Key Vault expiration checks. Covers best-practice assessment, resource review, policy/compliance validation, and security posture checks. WHEN: compliance scan, security audit, BEFORE running azqr (compliance cli tool), Azure best practices, Key Vault expiration check, expired certificates, expiring secrets, orphaned resources, compliance assessment.
minimal-run-and-audit
lllllllama/rigorpilot-skills
Rigor Run skill for README-first deep learning repo reproduction. Use when the task is specifically to capture or normalize evidence from the selected smoke test or documented inference or evaluation command and write standardized reprooutputs/ files, including patch notes when repository files changed. Do not use for training execution, initial repo intake, generic environment setup, paper lookup, target selection, hidden scientific-meaning changes, or end-to-end orchestration by itself.
seo-audit
coreyhaines31/marketingskills
When the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions "SEO audit," "technical SEO," "why am I not ranking," "SEO issues," "on-page SEO," "meta tags review," "SEO health check," "my traffic dropped," "lost rankings," "not showing up in Google," "site isn't ranking," "Google update hit me," "page speed," "core web vitals," "crawl errors," "indexing issues," "stuck on page 2," "striking distance keywords," "title tag rewrite," "low CTR," "local SEO," "Google Business Profile," or "map pack." Use this even if the user just says something vague like "my SEO is bad" or "help with SEO" — start with an audit. For building pages at scale to target keywords, see programmatic-seo. For adding structured data, see schema. For AI search optimization, see ai-seo.
firebase-security-rules-auditor
firebase/agent-skills
Audits Firebase (Firestore, Cloud Storage) security rules for vulnerabilities, privilege escalation, role bypasses, create vs update inconsistencies, resource exhaustion, type safety, size limits, and hasOnly ownership checks. Use when auditing/reviewing rules, running red-team rule assessments, or scoring against auditor checklists. Don't use for Firebase CLI (login, deploy), Auth, Crashlytics, Remote Config, or database queries.
audit
pbakaus/impeccable
Run technical quality checks across accessibility, performance, theming, responsive design, and anti-patterns. Generates a scored report with P0-P3 severity ratings and actionable plan. Use when the user wants an accessibility check, performance audit, or technical quality review.
competitors
coreyhaines31/marketingskills
When the user wants to create competitor comparison or alternative pages for SEO and buyer-facing use. Also use when the user mentions 'alternative page,' 'vs page,' 'competitor comparison,' 'comparison page,' '[Product] vs [Product],' '[Product] alternative,' 'competitive landing pages,' 'how do we compare to X,' 'competitor teardown,' 'audit our competitor pages,' 'are our comparison pages out of date,' or 'competitive asset audit.' Use this for any content that positions your product against competitors. Covers four formats: singular alternative, plural alternatives, you vs competitor, and competitor vs competitor. For auditing existing claims (not researching competitors from scratch, which is competitor-profiling; not technical SEO on these pages, which is seo-audit), use the asset audit here. For internal battle cards and sales-specific competitor docs, see sales-enablement.
