Positioning Ideas
phuryn/pm-skills
Brainstorm product positioning ideas differentiated from competitors.
Generate stories where ordinary people become crucial through their structural position in systems.
$ npx skills add jwynia/agent-skills --skill positional-revelation -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install jwynia/agent-skills positional-revelation --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/jwynia/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/creative/fiction/structure/positional-revelation .claude/skills/positional-revelation && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "positional-revelation" agent skill from https://github.com/jwynia/agent-skills/tree/main/skills/creative/fiction/structure/positional-revelation into .claude/skills/positional-revelation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "positional-revelation", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/jwynia/agent-skills/tree/main/skills/creative/fiction/structure/positional-revelationType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add jwynia/agent-skills --skill positional-revelation -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install jwynia/agent-skills positional-revelation --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jwynia/agent-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/creative/fiction/structure/positional-revelation .agents/skills/positional-revelation && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "positional-revelation" agent skill from https://github.com/jwynia/agent-skills/tree/main/skills/creative/fiction/structure/positional-revelation into .agents/skills/positional-revelation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "positional-revelation", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add jwynia/agent-skills --skill positional-revelation -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install jwynia/agent-skills positional-revelation --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jwynia/agent-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/creative/fiction/structure/positional-revelation .cursor/skills/positional-revelation && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "positional-revelation" agent skill from https://github.com/jwynia/agent-skills/tree/main/skills/creative/fiction/structure/positional-revelation into .cursor/skills/positional-revelation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "positional-revelation", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/jwynia/agent-skills.git --path skills/creative/fiction/structure/positional-revelation--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add jwynia/agent-skills --skill positional-revelation -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install jwynia/agent-skills positional-revelation --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jwynia/agent-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/creative/fiction/structure/positional-revelation .gemini/skills/positional-revelation && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "positional-revelation" agent skill from https://github.com/jwynia/agent-skills/tree/main/skills/creative/fiction/structure/positional-revelation into .gemini/skills/positional-revelation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "positional-revelation", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install jwynia/agent-skills positional-revelationInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add jwynia/agent-skills --skill positional-revelation -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/jwynia/agent-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/creative/fiction/structure/positional-revelation .github/skills/positional-revelation && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "positional-revelation" agent skill from https://github.com/jwynia/agent-skills/tree/main/skills/creative/fiction/structure/positional-revelation into .github/skills/positional-revelation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "positional-revelation", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add jwynia/agent-skills --skill positional-revelation -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install jwynia/agent-skills positional-revelation --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jwynia/agent-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/creative/fiction/structure/positional-revelation .opencode/skills/positional-revelation && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "positional-revelation" agent skill from https://github.com/jwynia/agent-skills/tree/main/skills/creative/fiction/structure/positional-revelation into .opencode/skills/positional-revelation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "positional-revelation", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
positional-revelationGenerate stories where ordinary people become crucial through their structural position in systems.
Positional Revelation is an agent skill from jwynia/agent-skills. Generate stories where ordinary people become crucial through their structural position in systems. Use when you want protagonists who aren't chosen ones but accidental pivots, when mundane jobs should reveal conspiracies, or when you need structurally inevitable involvement rather than coincidence.
Its SKILL.md is about 5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
The licence is MIT.
12 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit e02ec7e. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Positional Revelation loads about 5k tokens when it runs. Until then it costs about 81 tokens; SKILL.md has 2,275 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from jwynia/agent-skills at commit e02ec7e, republished under its MIT licence (© jwynia). 2,275 words, ~4,996 tokens.
.claude/skills/positional-revelation/SKILL.md (or your agent's skills folder).You help writers create stories where ordinary people in mundane positions become crucial to larger conflicts through their structural position in systems they don't fully understand. These protagonists are neither chosen ones nor trained investigators—they're people whose everyday competence accidentally positions them at critical systemic junctures.
Every society has people who, through no intention of their own, sit at information crossroads, maintain critical boundaries, or possess skills that become unexpectedly vital. Their involvement isn't coincidence or fate—it's structurally inevitable given their position.
Formula: Expertise → Access → Revelation → Entanglement
Jobs: Repair/Maintenance, Transportation, Translation, Inspection
Formula: Vulnerability → Exploitation → Insight → Unexpected Advantage
Jobs: Debt Collector, Addiction Counselor, Night Shift Worker, Cleaner/Janitor
Formula: Dual Belonging → Forced Translation → Impossible Neutrality
Jobs: Merchant/Trader, Mixed Heritage Individual, Border Guard, Diplomatic Spouse
Formula: Legacy Position → Network Activation → Unexpected Obligations
Jobs: Family Business Heir, Widow/Widower, Guild Successor, Property Caretaker
Formula: Boundary Maintenance → Standards Challenged → Interpretation Becomes Law
Jobs: Inspector/Auditor, Customs Officer, Archivist/Librarian, Gatekeeper
Formula: Routine Documentation → Records Become Crucial → Only Source of Truth
Jobs: Clerk/Bookkeeper, Chronicler/Journalist, Photographer/Artist, Weather Recorder
Formula: Protective Ignorance → Veil Pierced → Can't Return to Innocence
Jobs: Courier, Witness, Ceremonial Role, Child of Important Figure
Access: Data, patterns, communications Reveals: Conspiracies, hidden networks, pattern crimes
| Setting | Examples |
|---|---|
| Medieval | Scribe, Herald, Confessor |
| Industrial | Telegraph Operator, Secretary, Accountant |
| Modern | Data Analyst, IT Support, Social Media Moderator |
| Sci-Fi | Neural Network Maintainer, Memory Auditor |
| Fantasy | Rune Keeper, Dream Interpreter, Oracle Attendant |
Access: Supply chains, inventories, distribution Reveals: Artificial scarcity, theft, black markets
| Setting | Examples |
|---|---|
| Medieval | Granary Keeper, Well Guardian, Tithe Collector |
| Industrial | Warehouse Manager, Railway Dispatcher |
| Modern | Supply Chain Analyst, Logistics Coordinator |
| Sci-Fi | Atmosphere Allocator, Energy Grid Manager |
| Fantasy | Mana Custodian, Magical Component Trader |
Access: Transitions, thresholds, passages Reveals: Smuggling, infiltration, hidden movements
| Setting | Examples |
|---|---|
| Medieval | City Gate Guard, Bridge Toll Keeper, Harbor Master |
| Industrial | Immigration Officer, Quarantine Enforcer |
| Modern | TSA Agent, Border Guard, Cybersecurity Specialist |
| Sci-Fi | Airlock Operator, Dimensional Gateway Monitor |
| Fantasy | Portal Keeper, Ward Maintainer, Crossroads Guardian |
Access: Hidden spaces, broken things, infrastructure Reveals: Hidden modifications, surveillance, true conditions
| Setting | Examples |
|---|---|
| Medieval | Castle Mason, Aqueduct Keeper |
| Industrial | Boiler Operator, Mine Equipment Repairer |
| Modern | HVAC Technician, Network Administrator |
| Sci-Fi | Hull Repair Tech, Life Support Maintainer |
| Fantasy | Ward Renewal Specialist, Golem Repairer |
Access: Exchanges, deals, agreements Reveals: Money laundering, coercion, hidden economies
| Setting | Examples |
|---|---|
| Medieval | Market Weighmaster, Money Changer |
| Industrial | Bank Teller, Company Store Operator |
| Modern | Real Estate Agent, Insurance Adjuster |
| Sci-Fi | Credit Exchanger, Reality Mortgage Broker |
| Fantasy | Curse Broker, Wish Notary, Soul Contract Witness |
Access: Vulnerable populations, private spaces, intimate knowledge Reveals: Abuse, exploitation, systemic neglect
| Setting | Examples |
|---|---|
| Medieval | Wet Nurse, Hospice Keeper |
| Industrial | Asylum Attendant, Company Doctor |
| Modern | Elder Care Worker, Group Home Supervisor |
| Sci-Fi | Clone Creche Monitor, Stasis Ward Nurse |
| Fantasy | Familiar Keeper, Shapeling Nursery Attendant |
Select one of the seven archetypal patterns based on your story's needs.
Pick a universal job that fits your world and provides appropriate access.
Adapt the job to your setting's technology/magic and social structure.
| Layer | Question |
|---|---|
| Surface Reality | What does the character believe their job is? |
| Mechanism Truth | How does the system actually use their position? |
| Power Structure | Who benefits from this arrangement? |
| Systemic Lock | Why is this arrangement necessary? |
For each revelation, identify at least three groups who:
Personal → Professional → Community → Systemic
Discovery Cascade
Network Effects
Threshold Crossing
| Pitfall | Solution |
|---|---|
| Character too competent | Maintain domain-specific competence; incompetent at larger game |
| Involvement feels contrived | Make involvement structurally inevitable, not lucky |
| Character only reacts | Character's choices drive escalation, even if constrained |
| Character too powerful/powerless | Power grows in specific domain while vulnerability increases elsewhere |
| Personal resolution ignores system | Personal change alters relationship to system, doesn't destroy it |
The strength of this framework lies in creating protagonists whose involvement feels inevitable rather than coincidental. They're not chosen ones or lucky investigators—they're people whose ordinary position becomes extraordinary when systems shift, secrets emerge, or competing interests converge.
context/output-config.md in the projectstories/concepts/ or explorations/stories/Pattern: {protagonist-role}-positional-{date}.md
context/output-config.md{protagonist-role}-positional-{date}.mdTrigger phrases: "design the complete revelation", "map all the interests", "build the system"
| Task | Agent Type | When to Spawn |
|---|---|---|
| Position research | general-purpose | When modeling on real institutional roles |
| System consistency | Explore | When verifying against existing setting |
Pattern: The protagonist happens to be in the right place at the right time through luck rather than structural necessity. Why it fails: The power of positional revelation is that involvement feels inevitable, not lucky. "She happened to overhear" is coincidence; "Her job required processing that file" is structure. Fix: Work backward from the revelation. Ask: what position would necessarily encounter this information? Who would structurally occupy that position? Make the character's access an inherent feature of their role, not a bonus.
Pattern: The ordinary person in a mundane position suddenly displays investigative skills, combat abilities, or strategic thinking far beyond their role. Why it fails: The formula requires maintaining competence within domain. A filing clerk who becomes Jason Bourne breaks the premise. Their power comes from their structural position, not from hidden talents. Fix: Keep the protagonist competent in their domain—excellent at their job—but genuinely out of their depth in the larger game. They succeed through leveraging their unique access, not through becoming someone else.
Pattern: The protagonist passively receives information without any action or choice on their part—things just happen around them. Why it fails: Even accidental pivots must make choices. Pure passivity creates observers, not protagonists. The structural position creates opportunity; the character must act on it. Fix: Build in decision points. The clerk could ignore the discrepancy or investigate. The translator could pretend not to understand or probe deeper. The choice to engage is what transforms position into story.
Pattern: After the crisis resolves, the protagonist returns to normal life with no lasting consequences from their involvement. Why it fails: The lock-in mechanism exists because there are consequences. Knowledge changes people. Involvement creates obligations. The system doesn't simply release those who've seen behind the curtain. Fix: Design consequences that persist. New relationships that can't be dissolved. Knowledge that can't be forgotten. A reputation that follows them. The protagonist's life is permanently altered, even if the immediate crisis ends.
Pattern: The ordinary person ultimately brings down the entire corrupt system through their intervention. Why it fails: This elevates them to a hero role that contradicts the premise. Real systems are resilient. One person can expose a specific problem but rarely destroys the underlying structure. Fix: Scale the resolution appropriately. The protagonist can save specific people, expose specific crimes, shift the balance of power—but the larger system adapts and continues. Their victory is real but local.
| Skill | What it provides |
|---|---|
| worldbuilding | Systems and structures that create positional access |
| economic-systems | Economic roles that generate revelation opportunities |
| governance-systems | Institutional positions with structural access |
| Skill | What this provides |
|---|---|
| character-arc | Ordinary-person protagonists with structural motivations |
| underdog-unit | Individuals with positional leverage despite limited resources |
| moral-parallax | Systemic complicity explored through individual perspectives |
| Skill | Relationship |
|---|---|
| moral-parallax | Positional-revelation shows how people become involved; moral-parallax explores the ethical weight of their complicity |
| underdog-unit | Positional-revelation creates individual pivots; underdog-unit creates institutional outcast teams. Both use structural pressure differently |
© jwynia, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in skills/creative/fiction/structure/positional-revelation of jwynia/agent-skills.
Open the folder on GitHubat commit e02ec7e
Positional Revelation next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Positional Revelation this skilljwynia/agent-skills | 170 | — | ~5k | Automated safety check: Pass | MIT | |
| Positioning Ideasphuryn/pm-skills | 27k | — | ~751 | Automated safety check: Pass | MIT | |
| Story ReadinessDonchitos/Claude-Code-Game-Studios | 26k | — | ~6.9k | Automated safety check: Pass | MIT | |
| Job Storiesphuryn/pm-skills | 27k | — | ~743 | Automated safety check: Pass | MIT | |
| User Storiesphuryn/pm-skills | 27k | — | ~748 | Automated safety check: Pass | MIT | |
| Create StoriesDonchitos/Claude-Code-Game-Studios | 26k | — | ~7.3k | Automated safety check: Pass | MIT |
phuryn/pm-skills
Brainstorm product positioning ideas differentiated from competitors.
Donchitos/Claude-Code-Game-Studios
Is a story implementation-ready?. An agent skill from Donchitos/Claude-Code-Game-Studios.
phuryn/pm-skills
Turns a feature into job stories in the When, I want to, so I can format, each with six to eight acceptance criteria tied to the user's situation and outcome.
phuryn/pm-skills
Create user stories following the 3 C's (Card, Conversation, Confirmation) and INVEST criteria with descriptions, design links, and acceptance criteria.
Donchitos/Claude-Code-Game-Studios
Break one epic into implementable stories embedding TR-ID, ADR guidance, acceptance criteria.
AIDevGTM/gtm-cofounder
Build a positioning and narrative where the developer is the hero and a real trend is the villain.
jwynia/agent-skills
Diagnose devcontainer configuration problems and guide development environment setup.
jwynia/agent-skills
Create distinctive, production-grade frontend interfaces with high design quality.
jwynia/agent-skills
Orchestrate agile development workflows for Gitea repositories using the tea CLI.
jwynia/agent-skills
Generate game assets using AI image generation APIs (DALL-E, Replicate, fal.ai) and prepare them for Godot.
jwynia/agent-skills
Develop AI agents, tools, and workflows with Mastra v1 Beta and Hono servers.
jwynia/agent-skills
Create and manipulate PowerPoint PPTX files programmatically.
Generate stories where ordinary people become crucial through their structural position in systems. Positional Revelation is an agent skill from jwynia/agent-skills. Generate stories where ordinary people become crucial through their structural position in systems.
Positional Revelation fits situations like: you want protagonists who arent chosen ones but accidental pivots; mundane jobs should reveal conspiracies; you need structurally inevitable involvement rather than coincidence.
Run `npx skills add jwynia/agent-skills --skill positional-revelation -a claude-code`. Or copy the skill folder (skills/creative/fiction/structure/positional-revelation in jwynia/agent-skills) into .claude/skills/positional-revelation in your project. Claude Code loads it when a task matches its description.
Run `npx skills add jwynia/agent-skills --skill positional-revelation -a codex`. Or copy the skill folder (skills/creative/fiction/structure/positional-revelation in jwynia/agent-skills) into .agents/skills/positional-revelation in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jwynia/agent-skills --skill positional-revelation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/positional-revelation, .gemini/skills/positional-revelation, .github/skills/positional-revelation and .opencode/skills/positional-revelation in your project.
SKILL.md names no scripts, command-line tools or credentials: Positional Revelation is instructions for the agent only.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Positional Revelation is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
About 5k tokens (SKILL.md is roughly 20k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Positional Revelation: Positioning Ideas (phuryn/pm-skills, 27k stars), Story Readiness (Donchitos/Claude-Code-Game-Studios, 26k stars), Job Stories (phuryn/pm-skills, 27k stars) and User Stories (phuryn/pm-skills, 27k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
jwynia (a GitHub user) maintains it in jwynia/agent-skills, which has 170 GitHub stars. The repository holds 111 skills in this directory. The repository was last updated on February 24, 2026.
Source: jwynia/agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.