AGENT SKILL

evergreen-technical-book

Keep technical nonfiction durable by separating timeless concepts, decision frameworks, and reader outcomes from fast-changing tool walkthroughs, UI steps, versions, vendor details, and companion resources. Use when scoping, outlining, revising, or updating technical books, self-hosting guides, software manuals, DevOps books, or other technical manuscripts that risk becoming outdated.

License 许可
MIT
最近更新
2026-11-14
Stars
★ 1.6k
Forks
491

01 前言 Front Matter

name
evergreen-technical-book
license
MIT
metadata
{ "tags": "writing,books,nonfiction,technical-writing,evergreen", "version": "0.1.0", "category": "Writing", "displayName": "Evergreen Technical Book" }
description
Keep technical nonfiction durable by separating timeless concepts, decision frameworks, and reader outcomes from fast-changing tool walkthroughs, UI steps, versions, vendor details, and companion resources. Use when scoping, outlining, revising, or updating technical books, self-hosting guides, software manuals, DevOps books, or other technical manuscripts that risk becoming outdated.
compatibility
Codex, Claude Code, and other Agent Skills-compatible clients.

02 资源文件 6

03 SKILL.md 正文

Evergreen Technical Book

Core Lens

Technical books become durable when the printed or stable manuscript teaches long-lived principles, decision frames, mental models, and workflows while volatile commands, UI walkthroughs, vendor details, and version-specific steps live in updateable companion resources.

Use this skill to:

  • Decide what belongs in a technical book versus a website, repo, worksheet, video, or checklist.
  • Reduce version drift without making the book abstract.
  • Design update policies for companion resources.
  • Keep self-hosting, DevOps, software, or infrastructure books useful for years.
  • Revise drafts that are overloaded with tool minutia.

Reference Routing

Need Read
Evergreen concepts and terminology references/core/knowledge.md
Durability and split rules references/core/rules.md
Book vs companion examples references/core/examples.md
Fast durability checklist references/core/checklist.md
Split book and companion resources workflows/split-book-and-companion.md

Workflow

1. Identify The Durable Promise

State the reader outcome that should remain valuable for several years.

If the promise depends on one vendor, one UI, or one narrow tool version, decide whether the book is intentionally edition-based or should be reframed.

2. Classify Content By Half-Life

Tag each major section or artifact:

  • Durable: concepts, tradeoffs, failure modes, principles, mental models.
  • Semi-durable: workflows, architecture patterns, checklists, example configurations.
  • Volatile: UI clicks, prices, vendor policies, exact package versions, screenshots, short-lived tools.

3. Split The Content

Keep the book concrete, but move volatile detail to companion resources when it would quickly date the manuscript.

The book should still deliver the core promise without requiring an upsell, hidden resource, or fragile link.

4. Design Companion Resources

For each companion item, define:

  • Purpose.
  • Owner.
  • Update trigger.
  • Stable URL or repository path.
  • Version or last-reviewed note.
  • How the book references it without breaking if it changes.

5. Add Update Hooks

Create a maintenance plan:

  • Versioned examples.
  • Changelog or last-reviewed dates.
  • Issue/report path for readers.
  • Periodic review cadence.
  • Replacement policy for stale tools.

Output Format

When helping with an evergreen technical book, return:

  1. Durability diagnosis.
  2. Book vs companion split table.
  3. Recommended scope cuts or moves.
  4. Companion resource plan.
  5. Update policy and review cadence.
  6. Manuscript wording for volatile references.

Quality Bar

Do not solve drift by making the book vague. Keep the reader's path concrete while making volatile details easy to update and easy to skip when they age.

04 同仓库更多 Skills

hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-review-with-annotations

Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-find-and-synthesize-context

Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-update-docs

Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-records

Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-interactive-html

Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-collaborate-threads

Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.

★ 1.6k