Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add open-octo/octo-agent --skill structural-diagnosisgit clone --depth 1 https://github.com/open-octo/octo-agentWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/open-octo/octo-agent/structural-diagnosis)<a href="https://agentmods.dev/skills/open-octo/octo-agent/structural-diagnosis"><img src="https://agentmods.dev/badge/skills/open-octo/octo-agent/structural-diagnosis/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/open-octo/octo-agent/structural-diagnosis"><img src="https://agentmods.dev/badge/skills/open-octo/octo-agent/structural-diagnosis.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00142 | $0.02383 |
| Opus 5 | $0.00071 | $0.01192 |
| Sonnet 5 | $0.00028 | $0.00477 |
| Haiku 4.5 | $0.00014 | $0.00238 |
Grade A, and why
structural-diagnosis scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 133 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Skill: structural-diagnosis
这是诊断,不是重写。目标是告诉用户"这篇稿子需要哪种修改,先改哪里",不是 把稿子按自己的风格重写一遍。
怎么读
先通读全文再下笔写任何一条意见。 第一遍读的是"读起来的感受":哪里 读进去了、哪里注意力开始飘、哪里读着读着突然觉得累或者绕。不要在第一遍 就开始批注——很多看起来有问题的地方,往后读会发现是有意为之;很多真正的 问题,只有读完全文回头看才能看出来。
第二遍带着诊断的眼光读。这时候已经知道这篇稿子想做什么,问题变成了: 哪里做到了,哪里没做到。
关注顺序
按这个顺序读,不要跳着来(除非用户明确要求只看某一层):
- 读者承诺:开头几段/引言给读者立下了什么期待——要解决什么问题、 给出什么视角、论证到什么结论?后面的内容有没有兑现这个承诺,还是 悄悄漂移到了别的方向?
- 论证结构:核心论点、论据之间的因果关系、节奏、每个部分/段落的 功能。这篇稿子撑得起自己的分量吗,还是结构在向读者要求太多耐心? (对应虚构写作里"发展性编辑"关心的层面:前提、因果、节奏、场景 必要性。)
- 语气与文风:视角是否稳定、语气是否统一、是否有这篇稿子该有的 "自己的声音",还是读起来像"正确但没有个性的通用文字"?
- 段落层面的执行:清晰度、段落之间的推进、重复、句子结构、过度 解释、该留白的地方却说破了。有没有反复出现、削弱说服力的模式?
- 表层问题:语法、标点、用词一致性、格式。这一层只标"反复出现的 模式",不逐条列——单个错字不值得写进结构诊断报告。
除非用户明确要的是表层校对,不要一上来就挑错字。 表层问题确实重要, 但初稿失败的原因通常更大。一份结构诊断报告如果开头就是"这里少了个逗号", 而这篇稿子的论证结构本身是断的,那是在浪费作者的注意力。
先分清:结构问题 vs 执行问题
一个段落表达的是对的意思、但表达得笨拙——这是执行问题,需要重写,不需要 删掉。一个段落表达的是不该在这里出现的意思,或者这段完全没有起到结构性 作用——这是结构问题,再怎么润色文字都解决不了。
先看能看到的最大单元:整体论证有没有兑现开头立下的承诺?然后往下看到 章节层面、段落层面。高层级的问题会连累低层级的诊断——如果整体结构是断的, 在这个基础上诊断段落层面的问题是不可靠的。
诊断维度
- 承诺与兑现:开头教会读者期待什么?后面的内容有没有对得上?
- 因果链:事件/论点之间是互相推动、互相制约的关系,还是仅仅按顺序 排列?如果段落顺序打乱了也不影响理解,说明这是"罗列",不是"论证"。
- 段落功能:每个段落结束时,有什么发生了变化——读者的认知、态度, 或者论证向前推进了一步?如果什么都没变,这段是可以删或者合并的候选。
- 节奏:哪里推进太快、哪里拖沓、哪里持续同一强度让人麻木、哪里持续 平淡让人走神。
- 信息设计:什么被保留、什么被揭示、什么被重复、什么被解释了?读者 手里握着的问题是不是在往前拉着读,还是所有悬念都太早被解开了?
- 文体承诺:这篇稿子有没有兑现它承诺的那种阅读体验?一篇科普文章 如果从不让读者跟着推理过程走,就是没兑现科普该有的契约;一篇论辩文章 如果从不给出反方观点的正面处理,也是一样。
诊断报告结构
- 总体诊断:这份稿子需要哪种修改——不是列出所有能改进的地方,而是 找出最主要的问题。一篇需要重新组织结构的稿子,应该听到"结构需要重来", 而不是收到五十条不会再有意义(因为结构一改这些段落可能都不在了)的 段落级意见。
- 优先级队列:影响力最大的问题排在最前面,附理由。按"对读者体验的 损耗"排序:什么最拖累阅读体验?
- 主要意见:结构性/论证效果层面的问题,每条锚定到具体段落。说清楚 问题是什么、这个问题让读者付出了什么代价、建议往哪个方向改(删、挪动、 展开、重新框定、提前埋伏笔、延后交代结论、调整论证顺序)。不是替作者 开药方,是让作者看到该往哪个方向动。
- 段落/语气层面的模式:跨段落反复出现的模式,不是逐句罗列。说清楚 模式是什么,给两三个代表性例子,说明改了能有什么收获。
- 表层问题:只标反复出现的模式,或者影响理解的地方。单个错别字不 值得写进这份报告。
- 修订顺序:现在改什么、之后再改什么、为什么这么排序。告诉作者从 哪里开始,别在需要重新组织的部分上浪费时间去抛光文字。
编辑纪律
What ships with it
2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 7d ago First seen · 133 lines · 142 tokens per session scan A 67502d8e24b9
structural-diagnosis is a skill published in the GitHub repository open-octo/octo-agent (97 stars, last pushed yesterday), licensed MIT. It adds 142 tokens to every session and 2,383 once invoked, about $0.0007 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.
Other skills, from other repositories
ha-mac-control
Hope Agent native macOS desktop control — the standard maccontrol status / diagnostics / apps / dock / spaces / snapshot / visual / windows / menu / clipboard / dialog loop, target-first action rules, no-blind-coordinate policy, and recovery for stale AX/window/menu/dialog state. Load whenever using maccontrol, or…
ha-skill-creator
Create, edit, improve, or audit Hope Agent skills. Use when the user wants to: (1) create a new skill from scratch, (2) edit or improve an existing skill, (3) review or clean up a SKILL.md file, (4) run evaluations to test skill effectiveness, (5) optimize skill descriptions for better trigger accuracy. Trigger…
ha-browser
Hope Agent browser automation — the standard status → tabs → snapshot → act loop, stale-ref recovery rules, and what to do when login / 2FA / captcha / camera-prompt / dialog blocks progress. Load this skill whenever you reach for the browser tool. Trigger on: user asks the agent to open / control / click / scrape /…
ha-logs
A read-only troubleshooting skill for querying Hope Agent’s local SQLite databases, which store logs, conversations, and background-job status.
ha-pet-import
Safely import, select, switch, or enable a compatible desktop pet in Hope Agent. Resolve packages from any origin, including local folders, zip archives, pet.json plus a sprite, PNG/WebP atlases, chat attachments, repository or cloud files, direct HTTPS artifact URLs, and download pages. Use whenever a user asks to…
feishu
A toolkit for working with Feishu, also called Lark, a workplace collaboration platform. It covers documents, spreadsheets, files, wikis, approvals, calendars, and contacts.