Agent skill

Topic Outline

by xiaotianfotos in xiaotianfotos/homerail

Create and revise a structured topic outline from an evolving brief, audience, angle, thesis, sections, questions, and sources.

MITAuto-check passedEducation

Install Topic Outline

skills CLI
$ npx skills add xiaotianfotos/homerail --skill topic-outline -a claude-code

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

GitHub CLI
$ gh skill install xiaotianfotos/homerail topic-outline --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/xiaotianfotos/homerail.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/builtin/topic-outline/skills/topic-outline .claude/skills/topic-outline && 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
topic-outline
GitHub stars
994
Token cost
~392 tokens
SKILL.md length
208 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Create and revise a structured topic outline from an evolving brief, audience, angle, thesis, sections, questions, and sources.

  • Tasks that involve Essays and academic help
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Topic Outline is an agent skill from xiaotianfotos/homerail. Create and revise a structured topic outline from an evolving brief, audience, angle, thesis, sections, questions, and sources.

Its SKILL.md is about 390 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Education, covering Essays and academic help. The repository describes itself as: Voice-first local agent orchestration runtime for auditable DAG workflows. The licence is MIT.

When your agent uses it

  • Tasks that involve Essays and academic help

Example prompts

  • “/topic-outline”

What it can do on your machine

Read from SKILL.md and the folder at commit 916e343. 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

Topic Outline loads about 392 tokens when it runs. Until then it costs about 35 tokens; SKILL.md has 208 words of instructions outside code blocks.

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

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 xiaotianfotos/homerail at commit 916e343, republished under its MIT licence (© xiaotianfotos). 208 words, ~392 tokens.

Download SKILL.mdSave it as .claude/skills/topic-outline/SKILL.md (or your agent's skills folder).
name
topic-outline
description
Create and revise a structured topic outline from an evolving brief, audience, angle, thesis, sections, questions, and sources.

Topic Outline

Use this Skill when the user asks to plan, structure, or revise a content topic. Do not use it for a generic task checklist or for an outline the user did not request.

Call the current Tool catalog entry for com.homerail.topic-outline:upsert_topic_outline with the complete current outline. Its harness-safe wire name is supplied by the current turn and must not be guessed. Reuse one stable plugin-owned id such as com.homerail.topic-outline:current across turns so a revision replaces the same semantic node without colliding with Core or another plugin. A partial outline is valid: record what is known, preserve useful prior fields, and put only unresolved decisions in questions.

Keep the shape concise:

  • title names the topic, not the UI component.
  • brief, audience, angle, and thesis capture the current editorial direction.
  • outline contains ordered sections with short points and truthful status.
  • sources includes only real HTTP(S) references supplied or found through an authorized tool.
  • next_action states the next useful editorial step.
  • confidence reflects evidence, not presentation polish.

Use the matching topic-outline Tool only when it is listed for the current turn. Do not substitute a legacy dynamic widget. If the requested outline is not placed on the canvas, tell the user only that visible result and offer to retry.

© xiaotianfotos, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/builtin/topic-outline/skills/topic-outline of xiaotianfotos/homerail.

Open the folder on GitHubat commit 916e343

Compare with similar skills

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

Topic Outline compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Topic Outline this skillxiaotianfotos/homerail994—~392Automated safety check: PassMIT
Academic Paper StrategistAAASS554/codex-academic-paper-skills5391 repos~2.7kAutomated safety check: PassMIT
Modeling Paper Rubric and Model Selectoryushui2022/MathModel-Skill4541 repos~1.8kAutomated safety check: PassMIT
Humanities Thesisganzhi-black/humanities-thesis-skill637—~1.7kAutomated safety check: PassMIT
Skill Thesis Writeryanlin-cheng/skill-thesis-writer209—~1.6kAutomated safety check: PassCustom licence
Thesis CreatorStars-OC/thesis-creator230—~2.8kAutomated safety check: PassMIT

Similar skills

  • Academic Paper Strategist

    AAASS554/codex-academic-paper-skills

    A skill your agent uses when the user needs to plan, de-risk, or ground a software engineering / computer science undergraduate thesis from a real codebase before final writing.

    539 GitHub starsUsed in 1 repo~2.7k tokens
    EducationAuto-check passed
  • Builds a scoring-aligned outline for a mathematical modeling paper and a model selection plan with baseline, improvement and validation experiments.

    454 GitHub starsUsed in 1 repo~1.8k tokens
    EducationAuto-check passed
  • Humanities Thesis

    ganzhi-black/humanities-thesis-skill

    人文社科论文写作全流程指导。适用于文学、历史、哲学、社会学、传播学、新闻学、文化研究等领域的中文学术论文。当用户提到"论文""写论文""选题""文献综述""论文修改""论文结构""摘要翻译""帮我查文献""参考文献格式""论文没有新意""理论和文本脱节""章节之间缺乏逻辑""帮我检查论文""摘要翻译成英文""投稿准备""脚注格式"等场景时触发。覆盖从选题到投稿的全流程,包含防幻觉规则、学术数据库…

    637 GitHub stars~1.7k tokensUpdated 5 mo ago
    EducationAuto-check passed
  • Skill Thesis Writer

    yanlin-cheng/skill-thesis-writer

    跨学科AI论文写作助手,专为本科生/研究生论文写作提供全方位支持。当用户需要撰写论文内容、设计论文框架结构、优化学术语体风格、处理参考文献格式(GB/T 7714-2015)、生成统计分析表格、或降低AI生成文本痕迹时使用此技能。支持工科(计算机/电子/机械等)、心理学、教育学、管理学等多学科领域,符合中国学术论文写作规范。

    209 GitHub stars~1.6k tokensUpdated 6 mo ago
    EducationAuto-check passed
  • Thesis Creator

    Stars-OC/thesis-creator

    Walks Chinese undergraduates through writing a graduation thesis from topic to Word export, with text-similarity reduction and AI-text rate rewriting and checks.

    230 GitHub stars~2.8k tokensUpdated 4 mo ago
    EducationAuto-check passed
  • Aigc Detector

    free-revalution/AIGC-Detector-Pro

    Academic paper AI content detection, rewriting, and thesis writing assistant.

    142 GitHub stars~2.8k tokensUpdated 4 mo ago
    EducationAuto-check passed

More from xiaotianfotos/homerail

All 11 skills in this repo
  • Homerail Dag Ops

    xiaotianfotos/homerail

    Design, start, supervise, inspect, and continue HomeRail DAG workflows from any agent with CLI or HTTP access.

    994 GitHub stars~1.5k tokensUpdated 15 days ago
    Auto-check passed
  • Voice Generative UI

    xiaotianfotos/homerail

    Design and maintain truthful HomeRail generative UI for voice or text.

    994 GitHub stars~3.8k tokensUpdated 15 days ago
    Auto-check passed
  • Homerail CLI

    xiaotianfotos/homerail

    HomeRail CLI syntax, flags, configuration, and command reference.

    994 GitHub stars~3.4k tokensUpdated 15 days ago
    Auto-check passed
  • Homerail Install Ops

    xiaotianfotos/homerail

    Install, configure, start, verify, update, and troubleshoot a local-source HomeRail deployment for AI-agent use.

    994 GitHub stars~2k tokensUpdated 15 days ago
    Auto-check passed
  • Homerail PR Review

    xiaotianfotos/homerail

    Run HomeRail's built-in read-only pull request review DAG. An agent skill from xiaotianfotos/homerail.

    994 GitHub stars~670 tokensUpdated 15 days ago
    Auto-check passed
  • Homerail Shared

    xiaotianfotos/homerail

    Shared HomeRail rules for AI agents operating the local-source release candidate: service roles, environment variables, secrets, provider boundaries, Docker callback networking, update expectations…

    994 GitHub stars~1.5k tokensUpdated 15 days ago
    Auto-check passed

Categories

Questions about Topic Outline

What does Topic Outline do?

Create and revise a structured topic outline from an evolving brief, audience, angle, thesis, sections, questions, and sources. Topic Outline is an agent skill from xiaotianfotos/homerail. Create and revise a structured topic outline from an evolving brief, audience, angle, thesis, sections, questions, and sources.

When should I use Topic Outline?

Topic Outline fits situations like: tasks that involve Essays and academic help.

How do I install Topic Outline in Claude Code?

Run `npx skills add xiaotianfotos/homerail --skill topic-outline -a claude-code`. Or copy the skill folder (plugins/builtin/topic-outline/skills/topic-outline in xiaotianfotos/homerail) into .claude/skills/topic-outline in your project. Claude Code loads it when a task matches its description.

How do I install Topic Outline in Codex?

Run `npx skills add xiaotianfotos/homerail --skill topic-outline -a codex`. Or copy the skill folder (plugins/builtin/topic-outline/skills/topic-outline in xiaotianfotos/homerail) into .agents/skills/topic-outline in your project. Codex loads it when a task matches its description.

Can I use Topic Outline 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 xiaotianfotos/homerail --skill topic-outline -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/topic-outline, .gemini/skills/topic-outline, .github/skills/topic-outline and .opencode/skills/topic-outline in your project.

What does Topic Outline need to run?

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

Does Topic Outline 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 Topic Outline 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 Topic Outline use?

Topic Outline is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Topic Outline use?

About 392 tokens (SKILL.md is roughly 1.6k 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 Topic Outline?

Skills that share tags, products or a category with Topic Outline: Academic Paper Strategist (AAASS554/codex-academic-paper-skills, 539 stars), Modeling Paper Rubric and Model Selector (yushui2022/MathModel-Skill, 454 stars), Humanities Thesis (ganzhi-black/humanities-thesis-skill, 637 stars) and Skill Thesis Writer (yanlin-cheng/skill-thesis-writer, 209 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Topic Outline?

xiaotianfotos (a GitHub user) maintains it in xiaotianfotos/homerail, which has 994 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on September 25, 2026.

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