Token导航 LogoToken导航

Agent Skill · 研究检索

positional-revelation(位置启示)

positional-revelation 用于查找、检索和筛选相关信息,适合在 Codex、Claude、Cursor、Gemini CLI 中需要根据关键词、任务场景或来源线索快速定位候选结果时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。

positional-revelation 是研究检索类 Agent Skill,可用宿主为 Codex、Claude、Cursor、Gemini CLI,通过GitHub 仓库获取,权限为需要联网;许可证为 MIT,第三方扫描已通过,按安装量在研究检索类的 73,675 个 Skill 里排第 20,020。

总安装 5,363周安装 228GitHub Stars 69下载 1,879核验 2026-05-01

安装说明

本站只整理中文说明,不托管安装包,也不代用户安装。
GitHub
许可证
MIT

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:positional-revelation(位置启示)
来源仓库:https://github.com/jwynia/agent-skills
仓库路径:skills/positional-revelation
安装命令:
npx skills add https://github.com/jwynia/agent-skills --skill positional-revelation
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。不同来源提供的安装方式可能略有差异;本站展示可直接复制的安装命令,安装前请核对来源页面。

skills.shnpx skills
npx skills add https://github.com/jwynia/agent-skills --skill positional-revelation

这个 Skill 是做什么的

研究检索类 Skill 主要解决「找资料、核对事实、把来源整理清楚」的问题,通常会让助手先检索再总结。

positional-revelation 用于查找、检索和筛选相关信息。适用于根据关键词或任务场景快速定位候选结果的场景。支持在 Codex、Claude、Cursor、Gemini CLI 等宿主环境中使用。安装时需注意权限边界与潜在的文件读写或网络访问行为。

适用宿主包括 Codex、Claude、Cursor、Gemini CLI,接入前应确认版本、权限和运行环境要求。

来源仓库内路径:skills/positional-revelation

上手步骤

4 步
  1. 1

    确认自己的宿主工具

    公开资料标注支持 Codex、Claude、Cursor、Gemini CLI;先确认自己用的是其中之一,再按对应工具的 Skills 目录放置。

  2. 2

    拿到安装命令

    可以直接复制的命令是 npx skills add https://github.com/jwynia/agent-skills --skill positional-revelat…;命令里的占位符换成自己的路径或密钥再执行。

  3. 3

    安装后重启宿主

    命令执行完要完全退出宿主工具再打开,让新装的 Skill 被重新扫描到,否则列表里可能看不到。

  4. 4

    按最小权限试用

    它需要需要联网,先在测试目录或测试账号里跑,确认没问题再放到正式项目。

常见问题

6 条

positional-revelation 怎么安装?

在终端执行 npx skills add https://github.com/jwynia/agent-skills --skill positional-revelation。装完完全退出宿主工具再打开,让它重新扫描本地 Skill。

positional-revelation 支持哪些 AI 工具?

公开资料标注支持 Codex、Claude、Cursor、Gemini CLI。其他工具只要能读取本地 Skill 目录,一般也能手动放进去,但要自己确认触发方式是否一致。

positional-revelation 需要什么权限?

权限级别是需要联网。该 Skill 可能需要联网访问来源站点、仓库或外部 API;具体网络访问范围需要结合源码和 README 复核。

positional-revelation 是免费的吗?

来源标注的许可证是 MIT。本站不代收任何费用,也不托管安装包;能否商用、要不要署名,以许可证原文为准。

positional-revelation 用的人多吗?

公开数据是累计安装 5,363 次,近一周安装 228 次,下载 1,879 次,GitHub 69 星。这些数字来自第三方目录统计,只能当作热度参考,不代表质量或安全性。

positional-revelation 安全吗?

第三方扫描结果为通过,但这只覆盖已知的静态检查项,不能替代自己读一遍源码和安装命令。

值得选的地方和要先想清楚的地方

值得选的地方

  • 同时适配 4 种工具,换客户端不用重新找替代品。
  • 3 个目录同时收录,说明这个 Skill 流传比较广。
  • 许可证明确为 MIT,商用和分发边界好判断。
  • 第三方扫描已通过,常见的高风险行为没有命中。

先想清楚的地方

  • 第三方目录整理,版本更新和行为细节以来源仓库为准。

适不适合你

更适合

  • 已经在用 Codex,想直接扩展它能力的人。
  • 需要处理研究检索类任务、又不想每次都手写提示词的人。
  • 需要许可证清楚、并且有第三方扫描结果的团队项目。

不太适合

  • 需要厂商级技术支持和 SLA 的生产系统。

研究检索类 Skill 对比

6 个同类
Skill总安装GitHub 星权限许可证扫描
find-skills

寻找技能 · Codex、Claude

31,199,81316,486操作浏览器MIT有提醒
self-improving-agent

自我改进 Agent · OpenClaw

16,464,0023,396接触敏感数据MIT-0通过
soultrace

灵魂追踪 · Codex、Claude

7,588,94412需要联网未明确有提醒
self-improving

自我完善 · OpenClaw

6,829,2841,046需要联网MIT-0通过
microsoft-foundry

微软代工厂 · Codex、Claude

6,614,144764调用外部服务未明确有提醒
positional-revelation

位置启示 · 本页

5,36369需要联网MIT通过

按安装量取同分类前几名;数字来自第三方目录统计,只作热度参考,不代表质量结论。

SKILL.md 原文

Positional Revelation: Story Generation Skill

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.

Core Principle: The Accidental Pivot

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.

The Seven Archetypal Patterns

1. The Competence Trap

Formula: Expertise → Access → Revelation → Entanglement

  • Position: Someone skilled at a specific task
  • Activation: Their skill reveals hidden system layer
  • Lock-in: Their expertise becomes essential to all parties
  • Conflict: Can't unknow what they've learned; skills make them valuable to competing interests

Jobs: Repair/Maintenance, Transportation, Translation, Inspection

2. The Weakness Lever

Formula: Vulnerability → Exploitation → Insight → Unexpected Advantage

  • Position: Someone with a specific flaw or need
  • Activation: System targets their vulnerability
  • Lock-in: Weakness makes them invisible to power while granting unique perspective
  • Conflict: Their flaw is both liability and asset

Jobs: Debt Collector, Addiction Counselor, Night Shift Worker, Cleaner/Janitor

3. The Bridge Position

Formula: Dual Belonging → Forced Translation → Impossible Neutrality

  • Position: Someone existing between two worlds
  • Activation: Worlds must suddenly interact
  • Lock-in: Only person both sides partially trust
  • Conflict: Can't serve both without betraying one

Jobs: Merchant/Trader, Mixed Heritage Individual, Border Guard, Diplomatic Spouse

4. The Inherited Network

Formula: Legacy Position → Network Activation → Unexpected Obligations

  • Position: Someone who inherits role/relationships
  • Activation: Dormant network awakens
  • Lock-in: Network assumes continuity of previous holder
  • Conflict: Everyone expects them to know rules they don't

Jobs: Family Business Heir, Widow/Widower, Guild Successor, Property Caretaker

5. The Threshold Guardian

Formula: Boundary Maintenance → Standards Challenged → Interpretation Becomes Law

  • Position: Someone who maintains standards/boundaries
  • Activation: Novel situation challenges existing categories
  • Lock-in: Their technical decision has political ramifications
  • Conflict: Technical authority becomes political without consent

Jobs: Inspector/Auditor, Customs Officer, Archivist/Librarian, Gatekeeper

6. The Accidental Historian

Formula: Routine Documentation → Records Become Crucial → Only Source of Truth

  • Position: Someone who keeps mundane records
  • Activation: Past documentation determines future
  • Lock-in: They're the sole source of critical information
  • Conflict: Their credibility and interpretation become battleground

Jobs: Clerk/Bookkeeper, Chronicler/Journalist, Photographer/Artist, Weather Recorder

7. The Structural Innocent

Formula: Protective Ignorance → Veil Pierced → Can't Return to Innocence

  • Position: Someone deliberately kept ignorant for their role
  • Activation: Protection fails, truth emerges
  • Lock-in: Their innocence was functionally necessary
  • Conflict: Knowledge destroys ability to perform original role

Jobs: Courier, Witness, Ceremonial Role, Child of Important Figure

Universal Job Categories

Information Workers

Access: Data, patterns, communications Reveals: Conspiracies, hidden networks, pattern crimes

SettingExamples
MedievalScribe, Herald, Confessor
IndustrialTelegraph Operator, Secretary, Accountant
ModernData Analyst, IT Support, Social Media Moderator
Sci-FiNeural Network Maintainer, Memory Auditor
FantasyRune Keeper, Dream Interpreter, Oracle Attendant

Resource Managers

Access: Supply chains, inventories, distribution Reveals: Artificial scarcity, theft, black markets

SettingExamples
MedievalGranary Keeper, Well Guardian, Tithe Collector
IndustrialWarehouse Manager, Railway Dispatcher
ModernSupply Chain Analyst, Logistics Coordinator
Sci-FiAtmosphere Allocator, Energy Grid Manager
FantasyMana Custodian, Magical Component Trader

Boundary Keepers

Access: Transitions, thresholds, passages Reveals: Smuggling, infiltration, hidden movements

SettingExamples
MedievalCity Gate Guard, Bridge Toll Keeper, Harbor Master
IndustrialImmigration Officer, Quarantine Enforcer
ModernTSA Agent, Border Guard, Cybersecurity Specialist
Sci-FiAirlock Operator, Dimensional Gateway Monitor
FantasyPortal Keeper, Ward Maintainer, Crossroads Guardian

Maintenance Workers

Access: Hidden spaces, broken things, infrastructure Reveals: Hidden modifications, surveillance, true conditions

SettingExamples
MedievalCastle Mason, Aqueduct Keeper
IndustrialBoiler Operator, Mine Equipment Repairer
ModernHVAC Technician, Network Administrator
Sci-FiHull Repair Tech, Life Support Maintainer
FantasyWard Renewal Specialist, Golem Repairer

Transaction Facilitators

Access: Exchanges, deals, agreements Reveals: Money laundering, coercion, hidden economies

SettingExamples
MedievalMarket Weighmaster, Money Changer
IndustrialBank Teller, Company Store Operator
ModernReal Estate Agent, Insurance Adjuster
Sci-FiCredit Exchanger, Reality Mortgage Broker
FantasyCurse Broker, Wish Notary, Soul Contract Witness

Caretakers

Access: Vulnerable populations, private spaces, intimate knowledge Reveals: Abuse, exploitation, systemic neglect

SettingExamples
MedievalWet Nurse, Hospice Keeper
IndustrialAsylum Attendant, Company Doctor
ModernElder Care Worker, Group Home Supervisor
Sci-FiClone Creche Monitor, Stasis Ward Nurse
FantasyFamiliar Keeper, Shapeling Nursery Attendant

The Revelation Engine

Step 1: Choose Your Pattern

Select one of the seven archetypal patterns based on your story's needs.

Step 2: Select Job Category

Pick a universal job that fits your world and provides appropriate access.

Step 3: Translate to Setting

Adapt the job to your setting's technology/magic and social structure.

Step 4: Design Revelation Layers

LayerQuestion
Surface RealityWhat does the character believe their job is?
Mechanism TruthHow does the system actually use their position?
Power StructureWho benefits from this arrangement?
Systemic LockWhy is this arrangement necessary?

Step 5: Create Activation Event

  • Information: Accidentally receives wrong intel
  • Pattern: Notices discrepancy in routine work
  • Crisis: Emergency forces new responsibilities
  • Inheritance: Receives position with hidden obligations
  • Relationship: Someone from past appears with expectations

Step 6: Build Lock-in Mechanism

  • Knowledge Lock: They know too much to leave
  • Skill Lock: They're the only one who can do something crucial
  • Trust Lock: They're the only one multiple parties will deal with
  • Legal Lock: Legally obligated to continue
  • Moral Lock: Stopping would harm innocents

Step 7: Design Competing Interests

For each revelation, identify at least three groups who:

  • Want different outcomes
  • Need the protagonist's position/knowledge
  • Can offer different incentives/threats
  • Have incompatible end goals

Conflict Escalation

Stakes Progression

Personal → Professional → Community → Systemic

  1. Job at risk, reputation threatened
  2. Industry/guild/organization threatened
  3. Neighbors, family, local area impacted
  4. Entire social/economic/political order at stake

Momentum Builders

Discovery Cascade

  • Each answer raises two new questions
  • Each ally reveals a potential enemy
  • Each solution creates new problems

Network Effects

  • Helping one person obligates helping others
  • Reputation spreads faster than understanding
  • Past actions constrain future choices

Threshold Crossing

  • Small compromises accumulate
  • Suddenly past point of no return
  • System treats them as insider

Quick-Start Templates

Template 1: The Innocent Professional

  • Pattern: Competence Trap
  • Job: Translator
  • Revelation: They've been translating coded criminal communications
  • Lock-in: Only one who understands the dialect
  • Conflict: Criminals, law enforcement, and victims all need them

Template 2: The Desperate Survivor

  • Pattern: Weakness Lever
  • Job: Night Shift Cleaner
  • Revelation: Cleaning up crime scenes disguised as accidents
  • Lock-in: Need job for family member's medical treatment
  • Conflict: Blackmail, police pressure, moral obligation

Template 3: The Reluctant Heir

  • Pattern: Inherited Network
  • Job: Small Shop Owner (inherited)
  • Revelation: Shop is neutral ground for criminal negotiations
  • Lock-in: Breaking neutrality would start gang war
  • Conflict: Gang expectations, police pressure, community safety

Template 4: The Technical Arbiter

  • Pattern: Threshold Guardian
  • Job: Safety Inspector
  • Revelation: Their ruling determines if colony lives or dies
  • Lock-in: Only certified inspector in region
  • Conflict: Corporate pressure, colonist desperation, actual safety

Avoiding Common Pitfalls

PitfallSolution
Character too competentMaintain domain-specific competence; incompetent at larger game
Involvement feels contrivedMake involvement structurally inevitable, not lucky
Character only reactsCharacter's choices drive escalation, even if constrained
Character too powerful/powerlessPower grows in specific domain while vulnerability increases elsewhere
Personal resolution ignores systemPersonal change alters relationship to system, doesn't destroy it

Development Worksheet

Character Foundation

  1. What is their mundane job?
  2. What unique access does it provide?
  3. What do they believe their job accomplishes?
  4. What does their job actually accomplish?

System Revelation

  1. What is the first sign something is wrong?
  2. What pattern do they notice?
  3. What do they discover when they investigate?
  4. Why can't they just report it and walk away?

Competing Interests

  1. Who wants them to continue as normal?
  2. Who wants them to actively participate?
  3. Who wants them eliminated?
  4. Who offers a way out that isn't really?

Escalation Path

  1. Personal consequence for not acting
  2. Professional consequence for acting
  3. Community consequence for choosing side
  4. Systemic consequence of final choice

The Power of Structural Inevitability

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.

Output Persistence

Output Discovery

  1. Check for context/output-config.md in the project
  2. If found, look for this skill's entry
  3. If not found, ask user: "Where should I save positional revelation designs?"
  4. Suggest: stories/concepts/ or explorations/stories/

Primary Output

  • Pattern selection - One of seven archetypal patterns
  • Position definition - Job, access, beliefs
  • Revelation layers - Surface to systemic truth
  • Lock-in mechanism - Why they can't leave
  • Competing interests - Groups needing the protagonist

File Naming

Pattern: {protagonist-role}-positional-{date}.md

Verification (Oracle)

What This Skill Can Verify

  • Pattern fit - Does situation match chosen archetype? (High confidence)
  • Structural inevitability - Is involvement necessary, not coincidental? (High confidence)
  • Lock-in presence - Can protagonist actually leave? (Medium confidence)

What Requires Human Judgment

  • Plausibility - Would this position really have this access?
  • Protagonist sympathy - Will readers care about this ordinary person?
  • Escalation calibration - Are stakes appropriately scaled?

Oracle Limitations

  • Cannot assess whether structural involvement feels contrived
  • Cannot predict reader engagement with mundane positions

Feedback Loop

Session Persistence

  • Output location: See context/output-config.md
  • What to save: Pattern, position, layers, lock-in, interests
  • Naming pattern: {protagonist-role}-positional-{date}.md

Cross-Session Learning

  • Check for prior positional revelations in this setting
  • Ensure systemic consistency
  • Failed revelation structures inform anti-patterns

Design Constraints

This Skill Assumes

  • Protagonist is ordinary, not special
  • Position creates access through structure, not luck
  • Systems exist to be revealed

This Skill Does Not Handle

  • Hero narratives - Route to: character-arc (for chosen one types)
  • Team dynamics - Route to: underdog-unit
  • Systemic worldbuilding - Route to: governance-systems or economic-systems

Degradation Signals

  • Involvement feels coincidental, not structural
  • Protagonist displays sudden competence outside their domain
  • Clean exit available (undermines lock-in)

Reasoning Requirements

Standard Reasoning

  • Single pattern selection
  • Basic position design
  • Simple revelation structure

Extended Reasoning (ultrathink)

  • Full revelation arc - [Why: layers must build coherently]
  • Multi-stakeholder mapping - [Why: competing interests form complex network]
  • System design - [Why: position must fit larger structure]

Trigger phrases: "design the complete revelation", "map all the interests", "build the system"

Execution Strategy

Sequential (Default)

  • Pattern before position
  • Position before revelation layers
  • Layers before lock-in
  • Lock-in before competing interests

Parallelizable

  • Designing multiple competing interest groups
  • Research into different institutional positions

Subagent Candidates

TaskAgent TypeWhen to Spawn
Position researchgeneral-purposeWhen modeling on real institutional roles
System consistencyExploreWhen verifying against existing setting

Context Management

Approximate Token Footprint

  • Skill base: ~4k tokens (patterns + categories + engine)
  • With templates: ~5k tokens
  • With worksheet: ~5.5k tokens

Context Optimization

  • Focus on relevant pattern and job category
  • Universal job categories are reference, not required
  • Templates are starting points

When Context Gets Tight

  • Prioritize: Current pattern, active position
  • Defer: Full job category tables, all patterns
  • Drop: Development worksheet, quick-start templates

Anti-Patterns

1. Contrived Coincidence

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.

2. Sudden Competence

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.

3. Passive Revelation

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.

4. Clean Exits

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.

5. System Destruction

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.

Integration

Inbound (feeds into this skill)

SkillWhat it provides
worldbuildingSystems and structures that create positional access
economic-systemsEconomic roles that generate revelation opportunities
governance-systemsInstitutional positions with structural access

Outbound (this skill enables)

SkillWhat this provides
character-arcOrdinary-person protagonists with structural motivations
underdog-unitIndividuals with positional leverage despite limited resources
moral-parallaxSystemic complicity explored through individual perspectives

Complementary

SkillRelationship
moral-parallaxPositional-revelation shows how people become involved; moral-parallax explores the ethical weight of their complicity
underdog-unitPositional-revelation creates individual pivots; underdog-unit creates institutional outcast teams. Both use structural pressure differently

平台分布

Claude Code

28.16%
按下载量换算529

OpenCode

22.85%
按下载量换算429

Antigravity

19.66%
按下载量换算369

Codex

15.12%
按下载量换算284

Gemini CLI

8.34%
按下载量换算157

windsurf

3.91%
按下载量换算73

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

需要联网

该 Skill 可能需要联网访问来源站点、仓库或外部 API;具体网络访问范围需要结合源码和 README 复核。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。

继续浏览同类 Skills