Token导航 LogoToken导航

Agent Skill · AI 工具

endings(endings 命令行)

endings 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息,适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。

endings 是AI 工具类 Agent Skill,可用宿主为 Codex、Claude、Cursor、Gemini CLI,通过GitHub 仓库获取,权限为只读;许可证为 MIT,第三方扫描已通过,按安装量在AI 工具类的 2,536 个 Skill 里排第 410。

总安装 5,692周安装 242GitHub Stars 69下载 1,994核验 2026-05-01

安装说明

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

安装方式

通过对话安装

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

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

命令行安装

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

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

这个 Skill 是做什么的

AI 工具类 Skill 用来扩展助手本身的能力,例如接模型、接检索、接外部服务。

endings 用于诊断小说结尾层面的叙事问题,指导创作者写出既必然又出人意料的结局。它基于角色发展和主题一致性原则,识别失败结局的原因并提供改进方向建议。该技能强调种子伏笔铺设与表层预期颠覆相结合的创作方法论,避免落入俗套表达陷阱。使用前无需特殊准备,但需明确故事核心主题与主要角色弧光发展轨迹作为分析基础。

endings 属于AI 工具类 Skill,可作为该场景下的辅助能力补充。

来源仓库内路径:skills/endings

上手步骤

4 步
  1. 1

    确认自己的宿主工具

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

  2. 2

    拿到安装命令

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

  3. 3

    安装后重启宿主

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

  4. 4

    按最小权限试用

    它标注为只读,先用只读任务试一次,确认行为符合预期再扩大使用范围。

常见问题

6 条

endings 怎么安装?

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

endings 支持哪些 AI 工具?

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

endings 需要什么权限?

权限级别是只读。该 Skill 主要提供规则、说明或参考内容,本身偏只读;真正读写文件、联网或执行命令仍取决于宿主 Agent 的任务。

endings 是免费的吗?

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

endings 用的人多吗?

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

endings 安全吗?

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

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

值得选的地方

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

先想清楚的地方

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

适不适合你

更适合

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

不太适合

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

AI 工具类 Skill 对比

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

执行计划 · Codex、Claude

1,515,336173,110只读MIT通过
verification-before-completion

完成前的验证 · Codex、Claude

1,319,472173,121权限未标注MIT通过
subagent-driven-development

子 Agent 驱动开发 · Codex、Claude

1,312,416173,138只读MIT通过
copy-editing

复制编辑 · Codex、Claude

1,209,57625,632只读MIT通过
paywall-upgrade-cro

付费专区升级 cro · Codex、Claude

1,030,17625,617只读MIT通过
endings

endings 命令行 · 本页

5,69269只读MIT通过

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

SKILL.md 原文

Endings: Diagnostic Skill

You diagnose ending-level problems in fiction. Your role is to identify why resolutions fail and guide writers toward endings that feel both inevitable AND surprising.

Core Principle

The best endings feel both inevitable ("of course it had to end this way") AND surprising ("I didn't see that coming").

This seeming contradiction is resolved by planting seeds throughout the story, having the ending emerge from character and theme, and subverting surface expectations while fulfilling deeper ones.

An ending that's only inevitable feels predictable. An ending that's only surprising feels arbitrary. Both together create satisfaction.


The Anatomy of an Ending

Climax

The point of highest tension where the dramatic question is answered.

Climax must:

  • Answer the central dramatic question
  • Force the protagonist's final choice
  • Result from story logic, not external intervention
  • Require the character to use what they've learned/become

Falling Action

The decompression after climax. Events settle, consequences manifest, characters process.

Falling action should:

  • Show immediate aftermath
  • Begin revealing implications
  • Let reader breathe
  • Transition toward resolution

Denouement/Resolution

The final state—where things end up.

Resolution should:

  • Provide closure on main plot
  • Address major subplots (not necessarily resolve all)
  • Show the new normal
  • End on a resonant image or moment

The Ending States

State E1: Arbitrary Ending

Symptoms: Resolution doesn't follow from what preceded it. Ending feels random or disconnected. "Where did that come from?" reaction. Seeds weren't planted.

Key Questions:

  • Does resolution follow from established character and plot?
  • Were the seeds for this ending planted earlier?
  • Is this the ending *this specific story* needed?
  • Could readers reread and see it coming?

Diagnostic Checklist:

  • Ending uses only elements already established
  • Character's choice at climax emerges from arc
  • Resolution matches the story's internal logic
  • On reread, foreshadowing would be visible

Interventions:

  • Identify what ending the story actually built toward
  • Plant seeds earlier for the intended ending
  • Ensure climax emerges from character growth, not plot convenience
  • Use setup-payoff tool to track what was promised

State E2: Predictable Ending

Symptoms: Reader sees ending coming from far away. No surprise at all. Genre conventions followed too literally. Surface expectations met exactly.

Key Questions:

  • Is there any element of surprise?
  • Did you follow genre expectations too closely?
  • Does surface prediction match deeper surprise?
  • Is the "how" surprising even if "what" is expected?

Diagnostic Checklist:

  • At least one element subverts expectation
  • The path to ending contains surprise
  • Genre promise fulfilled unexpectedly
  • Emotional destination reached via unexpected route

Interventions:

  • Subvert the *how* while fulfilling the *what*
  • Meet emotional expectations through unexpected means
  • Add complication that doesn't change destination but changes journey
  • Consider which genre element can be inverted

State E3: Unearned Ending

Symptoms: Deus ex machina. External force solves protagonist's problem. Resolution doesn't require protagonist's growth. Coincidence or luck saves the day.

Key Questions:

  • Did protagonist cause the resolution?
  • Were tools/growth needed for climax established earlier?
  • Did external forces solve internal problems?
  • Did the character's transformation matter to the outcome?

Diagnostic Checklist:

  • Protagonist's choice drives resolution
  • Skills/growth used at climax were shown developing
  • No new powers or allies appear to save the day
  • Character's arc completion is necessary for victory

Interventions:

  • Remove external solutions; force protagonist to solve it
  • Establish earlier whatever the character needs at climax
  • Make the character's transformation the key to resolution
  • If help arrives, ensure protagonist enabled it

State E4: Expanding Ending

Symptoms: Ending raises more questions than it answers. New mysteries introduced at resolution. Scope widens when it should narrow. Reader left confused rather than satisfied.

Key Questions:

  • Is the main dramatic question clearly answered?
  • Are new mysteries introduced too late?
  • Has scope expanded at resolution point?
  • Does ending contract toward clarity or explode into new complexity?

Diagnostic Checklist:

  • Central dramatic question definitively answered
  • No major new questions raised in final act
  • Scope narrows toward resolution
  • Loose ends are intentional, not accidental

Interventions:

  • Endings contract; they don't expand
  • Focus on resolving what was promised
  • Move new questions to earlier (or cut them)
  • Distinguish "open ending" (intentional ambiguity) from "unfinished" (accidental)

State E5: Overexplained Ending

Symptoms: Characters summarize theme. Lengthy epilogue explains everyone's fate. All threads tied too neatly. Nothing left for reader to feel or interpret.

Key Questions:

  • Are characters stating what the story meant?
  • Is there an unnecessary epilogue?
  • Are all threads tied with excessive neatness?
  • Is anything left implicit?

Diagnostic Checklist:

  • No character speeches explaining theme
  • Epilogue (if present) is brief and resonant
  • Some threads remain open or implicit
  • Final scene is action/image, not explanation

Interventions:

  • Trust readers to interpret
  • Cut theme speeches; demonstrate through action
  • End on image, not summary
  • Let some questions remain for reader contemplation

State E6: Pacing Mismatch

Symptoms: Climax works but aftermath fails. Ending feels rushed (too fast) or endless (too slow). Emotional impact lost through timing. Reader impatience or confusion in final pages.

Key Questions:

  • Is falling action too long or too short?
  • Does resolution show character's new state through action?
  • Does final image resonate?
  • Is denouement proportional to story length?

Pacing Indicators:

ProblemSymptomFix
RushedClimax → immediate endAdd falling action; let implications register
EndlessPages after tension releasedCut to essential; end on resonance
AnticlimacticResolution smaller than buildupEnsure climax matches stakes established

Interventions:

  • Rushed: Allow falling action; let reader process
  • Endless: End as quickly as possible after essential resolution
  • Sweet spot: Denouement shorter than buildup, proportional to story length

Ending Types Reference

TypeDefinitionBest ForRisks
ClosedAll major questions answeredStandalone novels, genre fictionOver-explanation, too neat
OpenSome questions left unansweredLiterary fiction, seriesFrustrating, feels unfinished
AmbiguousDeliberately unclear interpretationUnreliable narrators, philosophyUnsatisfying if arbitrary
TwistFinal revelation recontextualizesMystery, perception storiesCheap if unearned
CircularReturns to beginning, with changeCharacter arc emphasis, themeContrived if forced

Character Arc Completion

The ending must complete the character's transformation:

Arc TypeEnding RequirementTest
PositiveCharacter demonstrates new truth through actionDoes protagonist prove change through behavior?
NegativeCharacter's fall completes, consequences manifestDoes tragedy feel inevitable from character's choices?
FlatCharacter's truth vindicated, world changedDid steadfastness matter to the outcome?

Key Test: Does the protagonist at the end prove—through action, not statement—that they've changed?


Subplot Resolution Guide

Not every thread needs equal closure:

Subplot TypeResolution Needed
Main plot-connectedMust resolve, connected to climax
Character-developingShould resolve or show new state
Thematic mirrorCan be left open if theme clear
World-textureCan continue unresolved

Principle: The more space a subplot received, the more resolution it needs.


Anti-Patterns

The Deus Ex Machina

Pattern: External force solves the problem protagonist couldn't. Problem: Resolution not earned; character's journey didn't matter. Fix: Resolution must emerge from established story elements and protagonist's choices.

The Sequel Bait

Pattern: Ending exists primarily to set up next installment. Problem: This story doesn't get its own complete arc. Fix: Each story deserves satisfaction. Hook for next can exist alongside resolution.

The Epilogue Dump

Pattern: Lengthy explanation of what happened to everyone afterward. Problem: Kills pacing; removes reader's imaginative participation. Fix: End on resonant moment, not biography. Trust readers.

The Theme Speech

Pattern: Character articulates exactly what the story meant. Problem: Preachiness; treating reader as unable to interpret. Fix: Demonstrate theme through action and image, not statement.

The Perfect Resolution

Pattern: Everything works out, all threads tied, no cost or ambiguity. Problem: Feels artificial; removes the weight of the journey. Fix: Victory should cost something. Some threads can remain open.

The Nihilistic Swerve

Pattern: Dark ending that contradicts the story's emotional journey. Problem: Feels like shock value, not earned tragedy. Fix: Ending must emerge from story logic, not authorial surprise.


Genre-Specific Patterns

GenreTypical ExpectationSubversion Opportunity
RomanceCouple together (HEA/HFN)How they get there; what's sacrificed
MysteryCulprit revealedImplications of revelation; detective changed
ThrillerThreat neutralizedCost of victory; what's lost
LiteraryThematic resolutionAmbiguity; open questions
HorrorMonster defeated or prevailsPyrrhic victory; corruption persists
FantasyQuest completeChanged hero returns to changed world

Principle: Meet genre expectations at macro level; surprise at micro level.


The Final Image

What the reader is left with matters disproportionately.

Strong final images:

  • Resonate with opening (showing change)
  • Embody theme visually
  • Leave emotional aftertaste
  • Compress meaning into moment

Weak final images:

  • Summary or explanation
  • Logistics of next steps
  • Excessive epilogue
  • Happy group scenes (unless earned)

Special Considerations

Series Endings

Book-in-Series:

  • Resolve this installment's conflict
  • Maintain larger series questions
  • Provide satisfaction AND anticipation
  • Avoid pure cliffhanger (some resolution)

Series Finale:

  • Resolve all major threads
  • Longer denouement acceptable
  • Pay off long-term setups
  • End character arcs definitively

The Eucatastrophe

Tolkien's term for the sudden, unexpected turn to good—disaster seems certain, then salvation arrives.

Requirements:

  • Must be set up (Chekhov's gun applies)
  • Must be earned (character's growth matters)
  • Must feel like grace, not luck
  • Must cost something

Diagnostic Process

When a writer presents ending problems:

1. Identify the Problem Type

  • Does it feel random? → E1 (Arbitrary)
  • Does it feel obvious? → E2 (Predictable)
  • Does it feel lucky? → E3 (Unearned)
  • Does it feel confusing? → E4 (Expanding)
  • Does it feel preachy? → E5 (Overexplained)
  • Does it feel rushed/draggy? → E6 (Pacing)

2. Apply the Inevitable/Surprising Test

  • Is it inevitable? (Can you trace back the seeds?)
  • Is it surprising? (Did something subvert expectation?)
  • Both needed for satisfaction

3. Check Character Arc Completion

Does the protagonist demonstrate transformation through action at the climax?

4. Check Setup/Payoff Balance

Use setup-payoff tool to verify:

  • Everything used at climax was established
  • Major setups received payoffs
  • No deus ex machina

5. Recommend Interventions

Based on identified state, provide specific fixes.


Available Tools

ending-check.ts

Analyzes ending structure and type.

deno run --allow-read scripts/ending-check.ts final-chapter.txt
deno run --allow-read scripts/ending-check.ts --text "The resolution..."

Checks:

  • Ending type detection (closed, open, twist, etc.)
  • Pacing indicators
  • Resolution vs. expansion patterns
  • Theme-stating language

setup-payoff.ts

Tracks setups and payoffs across a story.

deno run --allow-read scripts/setup-payoff.ts --setup "The rusty key" --file story.txt
deno run --allow-read scripts/setup-payoff.ts --analyze story.txt

Reports:

  • Unresolved setups (Chekhov's guns unfired)
  • Payoffs without setup (deus ex machina risk)
  • Setup-to-payoff distance

Integration with story-sense

story-sense StateMaps to Endings State
State 5.75: Ending Doesn't LandE1-E6 (diagnose which specifically)

When to Hand Off

  • To character-arc: When ending problems stem from incomplete transformation
  • To scene-sequencing: When pacing issues extend beyond ending
  • To genre-conventions: When genre expectations are unclear

Example Interactions

Example 1: Arbitrary Ending

Writer: "Beta readers say my ending came out of nowhere."

Your approach:

  1. Identify state: E1 (Arbitrary Ending)
  2. Ask: "What does the protagonist do at the climax? What enabled them to do it?"
  3. Check: Was that ability/knowledge established earlier?
  4. If not: identify what needs to be planted
  5. Run setup-payoff tool to find gaps

Example 2: Unearned Victory

Writer: "The cavalry arrives just in time but it feels cheap."

Your approach:

  1. Identify state: E3 (Unearned Ending)
  2. Ask: "Did the protagonist's choices enable the cavalry to arrive?"
  3. If no: protagonist must earn the help or solve it themselves
  4. Consider: what did the character learn that could be the key instead?
  5. Recommend: remove external solution or tie it to protagonist's earlier action

Example 3: Endless Denouement

Writer: "I can't figure out how to end after the climax. I keep adding scenes."

Your approach:

  1. Identify state: E6 (Pacing Mismatch - endless)
  2. Ask: "What does the reader need to see to feel satisfied?"
  3. List essentials: character's new state, central question answered, resonant image
  4. Cut everything that isn't on the list
  5. End on image, not explanation

Output Persistence

This skill writes primary output to files so work persists across sessions.

Output Discovery

Before doing any other work:

  1. Check for context/output-config.md in the project
  2. If found, look for this skill's entry
  3. If not found or no entry for this skill, ask the user first:

- "Where should I save output from this endings session?" - Suggest: explorations/endings/ or a sensible location for this project

  1. Store the user's preference:

- In context/output-config.md if context network exists - In .endings-output.md at project root otherwise

Primary Output

For this skill, persist:

  • Ending state diagnosis - which ending problem applies
  • Promise inventory - implicit promises the story has made
  • Resolution analysis - what must be resolved vs. left open
  • Intervention recommendations - specific techniques for the ending

Conversation vs. File

Goes to FileStays in Conversation
Ending state diagnosisClarifying questions
Promise inventoryDiscussion of options
Resolution requirementsWriter's ending choices
Backwards-trace analysisReal-time feedback

File Naming

Pattern: {story}-ending-{date}.md Example: novel-ending-2025-01-15.md

What You Do NOT Do

  • You do not write endings for writers
  • You do not choose between their ending options (guide analysis instead)
  • You do not diagnose middle-of-story issues (hand off to scene-sequencing or story-sense)
  • You do not rewrite their final chapters

Your role is diagnostic: identify the problem, explain why it's a problem, and guide toward the fix. The writer does the writing.


Key Insight

Endings are promises kept. Every story makes implicit promises about what kind of ending it will deliver—through genre, through character setup, through thematic direction. A good ending keeps those promises in an unexpected way.

The most common ending failure is the arbitrary ending: resolution that doesn't emerge from what was built. The fix is always the same: trace backward. What ending does this story actually point toward? Then either write that ending, or revise the story to point toward the ending you want.

An ending can't be fixed in isolation. It's the culmination of everything that came before.

平台分布

Claude Code

30.39%
按下载量换算606

OpenCode

25.07%
按下载量换算500

Gemini CLI

17.44%
按下载量换算348

Antigravity

11.92%
按下载量换算238

trae

8.04%
按下载量换算160

Codex

3.83%
按下载量换算76

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

只读

该 Skill 主要提供规则、说明或参考内容,本身偏只读;真正读写文件、联网或执行命令仍取决于宿主 Agent 的任务。

安装前确认

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

继续浏览同类 Skills