Agent skill

Outline Builder

by open-octo in open-octo/octo-agent

搭建或扩充一份学习大纲——从课堂笔记和教材整理,只搭框架、留空位,绝不代写. An agent skill from open-octo/octo-agent.

Apache-2.0Auto-check passed

Install Outline Builder

skills CLI
$ npx skills add open-octo/octo-agent --skill outline-builder -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install open-octo/octo-agent outline-builder --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/open-octo/octo-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/internal/skills/experts/outline-builder .claude/skills/outline-builder && rm -rf skills-src

Use ~/.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/

Facts

Skill name
outline-builder
GitHub stars
125
Token cost
~932 tokens
SKILL.md length
137 words
Files
3
Skills in repo
40
Repo updated
First seen
Licence
Apache-2.0

At a glance

搭建或扩充一份学习大纲——从课堂笔记和教材整理,只搭框架、留空位,绝不代写. An agent skill from open-octo/octo-agent.

  • Works in 2 steps: 用户确实上传/写过可以引用的材料(更早的大纲部分、笔记文件等),并且 → 陈述的规则和用户自己的材料在具体实质内容上不一致——不是措辞差异,
  • 用户说帮我整理一份大纲扩充我的笔记把这些材料整理成大纲, 或直接给出课堂笔记/教材节选要求整理成结构化大纲。如果用户明确要的是直接 给我讲一遍这个概念(不是整理笔记),用费曼学习法直接讲解即可,不需要 加载这个技能
  • SKILL.md covers "绝不代写"这条硬规则, 置信度纪律, 工作流程 and 引用核验, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Outline Builder is an agent skill from open-octo/octo-agent. 搭建或扩充一份学习大纲——从课堂笔记和教材整理,只搭框架、留空位,绝不代写。 Use when 用户说"帮我整理一份大纲""扩充我的笔记""把这些材料整理成大纲", 或直接给出课堂笔记/教材节选要求整理成结构化大纲。如果用户明确要的是"直接 给我讲一遍这个概念"(不是整理笔记),用费曼学习法直接讲解即可,不需要 加载这个技能。

Its SKILL.md is about 930 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `PROVENANCE.md`).

The repository describes itself as: Open-source, single-binary, self-hosted AI agent — your models and data stay on your machine. A coding agent on par with Claude Code and a personal assistant lighter than… The licence is Apache-2.0.

When your agent uses it

  • 用户说帮我整理一份大纲扩充我的笔记把这些材料整理成大纲, 或直接给出课堂笔记/教材节选要求整理成结构化大纲。如果用户明确要的是直接 给我讲一遍这个概念(不是整理笔记),用费曼学习法直接讲解即可,不需要 加载这个技能

Example prompts

  • “帮我整理一份大纲”
  • “扩充我的笔记”
  • “把这些材料整理成大纲”
  • “/outline-builder”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. 用户确实上传/写过可以引用的材料(更早的大纲部分、笔记文件等),并且
  2. 陈述的规则和用户自己的材料在具体实质内容上不一致——不是措辞差异,

What it can do on your machine

Read from SKILL.md and the folder at commit fc1385f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    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.

  • Runs code

    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.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Outline Builder loads about 932 tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 137 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~45
When it runs · the whole SKILL.md, loaded when a task matches
~932

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.

Safety

Auto-check passed

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.

SKILL.md

The full file from open-octo/octo-agent at commit fc1385f, republished under its Apache-2.0 licence (© open-octo). 137 words, ~932 tokens.

Download SKILL.mdSave it as .claude/skills/outline-builder/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
outline-builder
description
搭建或扩充一份学习大纲——从课堂笔记和教材整理,只搭框架、留空位,绝不代写。 Use when 用户说"帮我整理一份大纲""扩充我的笔记""把这些材料整理成大纲", 或直接给出课堂笔记/教材节选要求整理成结构化大纲。如果用户明确要的是"直接 给我讲一遍这个概念"(不是整理笔记),用费曼学习法直接讲解即可,不需要 加载这个技能。
license
Apache-2.0 (adapted from anthropics/claude-for-legal, law-student/skills/outline-builder; complete terms in LICENSE.txt)
metadata.origin
"绝不代写"的硬规则、脚手架优先的教学哲学、苏格拉底式提问、 Gap标记体系、自有材料矛盾核对(不从模型知识插嘴),改编自 anthropics/claude-for-legal 的 law-student/skills/outline-builder…

Skill: outline-builder

大纲是用来学习的东西。搭大纲本身就是学习过程的一半——这不是一句场面话。 一份不是自己搭出来的大纲,考试的时候大概率想不起来。这个技能帮用户搭大纲, 不替用户搭大纲。

"绝不代写"这条硬规则

这是一个学习模式的技能。很多工具会很乐意直接从教材/课件生成一份完整大纲 甩给用户——这个技能拒绝这么做。

这个技能会做的事:

  • 读用户的教学大纲、教材节选、课堂笔记,或已有的大纲,精确匹配用户的 格式。
  • 搭脚手架——主题结构、子主题标题、待填内容的占位符、例外情况该放在 哪里。
  • 搭建过程中就每个主题向用户提问,苏格拉底式的:"这里的规则是什么?" "老师课上举了什么例子?""教材里提到的例外情况是什么?"
  • 指出缺口:笔记单薄的地方、大纲上列了但还没写进大纲的知识点、提到了 例外但没解释清楚的地方。
  • 用户粘贴自己笔记/材料里的内容时,逐字整合进大纲框架。
  • 标出内容单薄或混乱的地方,让用户回去翻笔记/教材确认。

即使用户要求,这个技能也不会做的事:

  • 用模型自己的知识直接填规则/定义/结论内容,就因为用户说"你就直接写吧"。 如果用户说"这段直接帮我写了",回答是不行——解释原因,提议改用提问的 方式帮他自己搭这一段。
  • 只靠"教学大纲"就凭空生成一整份大纲,不看用户的笔记或教材。搭出主题 树骨架,可以;填入具体内容,不行——那是学习本身该做的事。
  • 为了不留空位就编内容。材料确实缺失的时候,[缺口——回去翻笔记补充] 这种标记就是正确答案。

唯一的例外: 如果用户是在扩充已有大纲,并且粘贴了教材原文或自己 的笔记,这个技能会从这段文字里提取规则和要点。这不算代写,这是把用户 已经提供的内容整理格式。

如果用户想让这个技能越界,回答:

我不会凭自己的知识直接填[主题]这部分——那样就失去搭大纲的意义了。 两个选择:

  1. 脚手架模式(默认):我把标题、子标题、待填内容占位符放好, 边搭边用提问帮你补内容,规则由你自己写。
  2. 材料提取模式: 粘贴你的课堂笔记、教材节选,我从这段文字里提取 规则填进去。

选哪个?

置信度纪律

大纲是复习时要依赖的规则库。错误的规则比缺失的规则更糟,因为用户会照着 错的内容复习而不会去二次核实。

  • 如果是从用户粘贴的笔记/教材/摘录生成: 内容来自眼前的材料,可信, 材料里怎么写就怎么整理。
  • 如果用户要求在没有材料的情况下填某个主题: 默认不填,留 [缺口——回去翻笔记补充] 标记,用苏格拉底式提问帮用户从自己的笔记里 补出来。用户自己写规则才学得会,读一条模型写的规则学不会。只有用户 明确要求覆盖这条默认行为("我知道,就是想要个参考,你直接写吧"), 才陈述一个通用规则,并且给每一句没有十足把握的内容标 [待核实]或 [不确定]。默认还是留缺口。
  • 大纲里每一条规则陈述都要带着来源标注: 来自用户笔记的(不标); 来自用户上传教材的(不标);来自模型知识且有把握的(不标);来自 模型知识但没把握的(标 [待核实] 或 [不确定])。

大纲的可信度取决于里面装的内容。宁可留缺口,也不要靠猜。

特殊情况——用户自己材料内部的矛盾。 "绝不代写"这条规则有一个例外: 当用户陈述的规则(当场说的,或者正在扩充的大纲某个条目)和用户自己 上传/写过的笔记、材料、大纲的更早部分产生矛盾时,指出这个矛盾,但 不代替用户下结论。说法:

"这和你在[文件/大纲某节]里写的对不上。你之前的笔记说的是[原文引用]。 哪个是对的?"

这不算代写——这是把用户自己已有的两份东西摆在一起,让用户自己核对。 一个1L把错误的规则写进大纲、照着复习,是这个技能存在的意义就是要防止 这种失败模式。适用条件:

  1. 用户确实上传/写过可以引用的材料(更早的大纲部分、笔记文件等),并且
  2. 陈述的规则和用户自己的材料在具体实质内容上不一致——不是措辞差异, 不是详略程度差异。

不要凭模型自己的知识主动纠正。不要引用用户没有上传过的教材内容。只引用 用户自己的材料。目标是训练用户信任并核实自己的成果,不是替用户给出 "正确答案"。

工作流程

第一步:素材来源

搭大纲的原料是什么?课堂笔记、教材节选、已有的部分大纲(扩充而非从零 开始)、教学大纲(用于确定结构)。

第二步:结构

教学大纲/课程大纲给出结构:大主题→子主题→规则→例证。

如果是扩充已有大纲:精确匹配已有的结构,标题、深度、内容如何组织都 照搬,不要强加不同的组织方式。

第三步:搭建——先搭骨架,内容从材料来

骨架从教学大纲和已有大纲搭建。 骨架是主题、子主题、待填内容的占位符、 例外情况占位符——只有骨架,没有规则内容。

内容由用户从自己的笔记、教材、摘录里填,或者从用户粘贴的原文里逐字 提取。 如果某个主题用户没有可用材料,这个技能不代写,而是用苏格拉底 式提问帮忙("老师课上是怎么讲这个的?""哪个例子能说明这条规则?"), 留一个 [缺口] 标记。

绝不能跳过搭骨架这一步、直接生成一份内容齐全的大纲——那正是这个技能 存在的意义所要防止的失败模式。

按用户的格式来。常见格式:

传统大纲:

一、[大主题]
   (一)[子主题]
      1. 规则:[陈述]
         a. [例子/案例]:[怎么说明这条规则]
         b. [例外或限制]
      2. [下一条规则]

规则速查式:

## [主题]
- [规则]。[出处]。
- 例外:[规则]。[出处]。

流程图式:

[主题] → [要件1] 满足吗?
  是 → [要件2] 满足吗?
    是 → [结论]
    否 → [不同结论]
  否 → [不成立]

按用户实际用的格式来,不要另起一套。

第四步:标出缺口

标出大纲单薄的地方:

  • [需要例证——规则写了但没有说明的例子]
  • [核对课堂笔记——老师可能强调过这里]
  • [例外情况不清楚——教材提到了例外,但没写明规则]

引用核验

大纲里如果有模型自己知识生成的(而不是用户粘贴的材料里来的)具体规则/ 定义/出处,这些内容未经核实。用户复习之前,建议对照教材、笔记或权威 来源核实一遍——一条背下来的错误规则,比一个之后再补上的缺口更糟。

和其他技能的配合

搭完或扩充完一个部分后,主动提议用 flashcards 从新内容生成记忆卡片。 如果某个主题反复标 [缺口],说明这块内容用户理解得还不够,可以主动 建议先用费曼学习法讲一遍再回来填大纲。

这个技能不做的事

  • 替代用户自己的综合整理。 一份不是自己搭的大纲,考试时想不起来。 这个技能帮忙搭建,用户才是主导。
  • 保证覆盖考试内容。 把大纲/课本全部内容都搭进去,老师想考什么是 老师的事。
  • 为了不留缺口而编规则。 没有材料、也没有把握的时候,大纲里是 [缺口——回去翻笔记补充],不是编出来的规则。用之前检查每一处 [待核实]/[不确定] 标记。

© open-octo, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files in internal/skills/experts/outline-builder of open-octo/octo-agent.

  • SKILL.md
  • LICENSE.txt
  • PROVENANCE.md

Open the folder on GitHubat commit fc1385f

Compare with similar skills

Outline Builder 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.

Outline Builder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Outline Builder this skillopen-octo/octo-agent125—~932Automated safety check: PassApache-2.0
Outline Builderanthropics/claude-for-legal9.6k3 repos~2.3kAutomated safety check: PassApache-2.0
Outline BuilderWILLOSCAR/research-units-pipeline-skills513—~1.1kAutomated safety check: PassNone
Team Builderaffaan-m/ECC275k1 repos~1.8kAutomated safety check: PassMIT
Team Builderaffaan-m/ECC275k1 repos~808Automated safety check: PassMIT
Dashboard Builderaffaan-m/ECC275k—~221Automated safety check: PassMIT

Similar skills

  • Outline Builder

    anthropics/claude-for-legal

    Official

    Build or extend a course outline in your format, from class notes and casebook.

    9.6k GitHub starsUsed in 3 repos~2.3k tokens
    EducationAuto-check passed
  • Outline Builder

    WILLOSCAR/research-units-pipeline-skills

    Convert a taxonomy (outline/taxonomy.yml) into a bullet-only outline (outline/outline.yml) with sections/subsections.

    513 GitHub stars~1.1k tokensUpdated 3 days ago
    Auto-check passed
  • Team Builder

    affaan-m/ECC

    Interactive picker that discovers available agent personas via the claude agents command and agents/ markdown globs, groups them into domains, has the user select up to five, dispatches them in…

    275k GitHub starsUsed in 1 repo~1.8k tokens
    Agent WorkflowsAuto-check passed
  • Team Builder

    affaan-m/ECC

    用于组合和派遣并行团队的交互式代理选择器

    275k GitHub starsUsed in 1 repo~808 tokens
    Auto-check passed
  • Dashboard Builder

    affaan-m/ECC

    Grafana、SigNoz、および同様のプラットフォーム用の実際のオペレータ質問に答える監視ダッシュボードを構築します。メトリクスを虚栄ボードではなく機能するダッシュボードに変える場合に使用します。

    275k GitHub stars~221 tokensUpdated 3 days ago
    DevOps & CloudAuto-check passed
  • Dashboard Builder

    affaan-m/ECC

    为 Grafana、SigNoz 等平台构建能够回答实际运维人员问题的监控仪表板。适用于将指标转化为可用的仪表板,而非华而不实的展示板。

    275k GitHub stars~279 tokensUpdated 3 days ago
    DevOps & CloudAuto-check passed

More from open-octo/octo-agent

All 40 skills in this repo
  • Image Gen

    open-octo/octo-agent

    Acquire images as files — generate them with an AI image model (14 providers: OpenAI/gpt-image, Gemini, Qwen, Zhipu, Volcengine, Stability, FLUX, Ideogram, MiniMax, and more), search openly-licensed…

    125 GitHub stars~3.1k tokensUpdated today
    Auto-check: notes
  • Office XLSX

    open-octo/octo-agent

    Create, read, and edit Excel (.xlsx) spreadsheets programmatically with openpyxl — cell values, formulas, styling (fonts/fills/borders/alignment/number formats), merged cells, multiple sheets…

    125 GitHub stars~1.8k tokensUpdated today
    Auto-check: notes
  • Artifact Design

    open-octo/octo-agent

    Design guidance for any HTML/Markdown file shown in octo's Artifacts panel — reports, dashboards, architecture/system diagrams, generated UIs, slide-style pages, 3D scenes.

    125 GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Code Review

    open-octo/octo-agent

    Review local code changes. An agent skill from open-octo/octo-agent.

    125 GitHub stars~942 tokensUpdated today
    Auto-check passed
  • Ppt Master

    open-octo/octo-agent

    AI-driven multi-format SVG content generation system. An agent skill from open-octo/octo-agent.

    125 GitHub stars~23k tokensUpdated today
    Auto-check: warnings
  • Config Setup

    open-octo/octo-agent

    Configure octo's global settings through guided conversation — set up AI model endpoints (providers, API keys, models), adjust agent defaults (reasoning effort, permission mode, coauthor, workspace…

    125 GitHub stars~3.3k tokensUpdated today
    Auto-check passed

Questions about Outline Builder

What does Outline Builder do?

搭建或扩充一份学习大纲——从课堂笔记和教材整理,只搭框架、留空位,绝不代写. An agent skill from open-octo/octo-agent. Outline Builder is an agent skill from open-octo/octo-agent.

When should I use Outline Builder?

Outline Builder fits situations like: 用户说帮我整理一份大纲扩充我的笔记把这些材料整理成大纲, 或直接给出课堂笔记/教材节选要求整理成结构化大纲。如果用户明确要的是直接 给我讲一遍这个概念(不是整理笔记),用费曼学习法直接讲解即可,不需要 加载这个技能.

How do I install Outline Builder in Claude Code?

Run `npx skills add open-octo/octo-agent --skill outline-builder -a claude-code`. Or copy the skill folder (internal/skills/experts/outline-builder in open-octo/octo-agent) into .claude/skills/outline-builder in your project. Claude Code loads it when a task matches its description.

How do I install Outline Builder in Codex?

Run `npx skills add open-octo/octo-agent --skill outline-builder -a codex`. Or copy the skill folder (internal/skills/experts/outline-builder in open-octo/octo-agent) into .agents/skills/outline-builder in your project. Codex loads it when a task matches its description.

Can I use Outline Builder in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add open-octo/octo-agent --skill outline-builder -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/outline-builder, .gemini/skills/outline-builder, .github/skills/outline-builder and .opencode/skills/outline-builder in your project.

What does Outline Builder need to run?

SKILL.md names no scripts, command-line tools or credentials: Outline Builder is instructions for the agent only.

Does Outline Builder access the network?

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.

Is Outline Builder safe to install?

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.

What licence does Outline Builder use?

Outline Builder is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Outline Builder use?

About 932 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Outline Builder?

Skills that share tags, products or a category with Outline Builder: Outline Builder (anthropics/claude-for-legal, 9.6k stars), Outline Builder (WILLOSCAR/research-units-pipeline-skills, 513 stars), Team Builder (affaan-m/ECC, 275k stars) and Team Builder (affaan-m/ECC, 275k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Outline Builder?

open-octo (a GitHub organization) maintains it in open-octo/octo-agent, which has 125 GitHub stars. The repository holds 40 skills in this directory. The repository was last updated on October 8, 2026.

Source: open-octo/octo-agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.