Agent skill

Higher Order Article Writer

by digoal in digoal/blog

Read a provided URL, local file, or pasted article, digest its core claims and assumptions, rebuild the topic into a concise original source-backed Chinese Markdown article, and save it under the…

GPL-2.0Auto-check passedDocuments & Office

Install Higher Order Article Writer

skills CLI
$ npx skills add digoal/blog --skill higher-order-article-writer -a claude-code

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

GitHub CLI
$ gh skill install digoal/blog higher-order-article-writer --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/digoal/blog.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/higher-order-article-writer .claude/skills/higher-order-article-writer && 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
higher-order-article-writer
GitHub stars
8.6k
Token cost
~1.7k tokens
SKILL.md length
799 words
Files
2
Skills in repo
98
Repo updated
First seen
Licence
GPL-2.0

At a glance

Read a provided URL, local file, or pasted article, digest its core claims and assumptions, rebuild the topic into a concise original source-backed Chinese Markdown article, and save it under the…

  • Works in 7 steps: Collect the source material. → Digest the source before writing. → Audit the source logic internally. → …
  • The user asks to upgrade
  • SKILL.md covers Overview, Workflow, Output Structure and Writing Requirements
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Higher Order Article Writer is an agent skill from digoal/blog. Read a provided URL, local file, or pasted article, digest its core claims and assumptions, rebuild the topic into a concise original source-backed Chinese Markdown article, and save it under the current project's markdown directory. Use when the user asks to upgrade, elevate, rewrite, extend, deconstruct, critique, refine, or produce a higher-order article from an existing article or URL, especially when the desired output should preserve the source insight but feel like a clean standalone article rather than an…

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Documents & Office. The repository describes itself as: AI,Opensource,Database,Business,Finance,Minds. git clone --depth 1 https://github.com/digoal/blog. The licence is GPL-2.0.

When your agent uses it

  • The user asks to upgrade
  • Produce a higher-order article from an existing article

Example prompts

  • “/higher-order-article-writer”

Workflow steps

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

  1. Collect the source material.
  2. Digest the source before writing.
  3. Audit the source logic internally.
  4. Rebuild with first principles.
  5. Support the new thesis.
  6. Check "逻辑三洽".
  7. Write the final Markdown article and save it.

What it can do on your machine

Read from SKILL.md and the folder at commit ad6fcb7. 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 (its code samples are markdown).

    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

Higher Order Article Writer loads about 1.7k tokens when it runs. Until then it costs about 143 tokens; SKILL.md has 799 words of instructions outside code blocks.

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

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 digoal/blog at commit ad6fcb7, republished under its GPL-2.0 licence (© digoal). 799 words, ~1,654 tokens.

Download SKILL.mdSave it as .claude/skills/higher-order-article-writer/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
higher-order-article-writer
description
Read a provided URL, local file, or pasted article, digest its core claims and assumptions, rebuild the topic into a concise original source-backed Chinese Markdown article, and save it under the current project's markdown directory. Use when the user asks to upgrade, elevate, rewrite, extend, deconstruct, critique, refine, or produce a higher-order article from an existing article or URL, especially when the desired output should preserve the source insight but feel like a clean standalone article rather than an analysis of the source.

Higher Order Article Writer

Overview

Use this skill to transform an existing article into a sharper, higher-level standalone article. Digest the source deeply, but do not expose the scaffolding or describe what the source article said unless the user explicitly asks for critique. The final article should read like an original piece: concise, focused, source-backed, and centered on one clear thesis.

Default to Chinese output unless the user explicitly asks for another language.

Workflow

  1. Collect the source material.

    • If the user gives a URL, fetch and read the page. If browsing is needed, use current web sources and cite links.
    • If the user gives article text or a local file, use that as the primary source.
    • If the source is paywalled, inaccessible, or too sparse, state the limitation and proceed only with the available text.
  2. Digest the source before writing.

    • Extract 3-7 core claims.
    • For each claim, identify the foundational assumption, supporting data, case evidence, and reasoning chain.
    • Compress the old article into one concise internal conclusion that includes: assumptions, claims, evidence, cases, and logic.
    • Do not start the new article until this extraction is coherent.
  3. Audit the source logic internally.

    • Find unsupported leaps, hidden premises, causality/correlation confusion, missing counterexamples, stale data, selection bias, false dichotomies, and incentive blind spots.
    • Separate "the article is wrong" from "the article is incomplete under changed assumptions".
    • Keep useful claims when their assumptions still hold.
  4. Rebuild with first principles.

    • Identify the most fragile or incomplete foundational assumption in the source.
    • Replace it with a new foundational assumption grounded in observable mechanisms.
    • Derive the new thesis from constraints, incentives, resource flows, balance sheets, user behavior, technology limits, policy rules, or other primary mechanisms relevant to the topic.
    • Make the new viewpoint explicit, not merely "more balanced".
    • Select 2-4 points that best support the thesis; cut secondary points unless they are necessary.
  5. Support the new thesis.

    • Use authoritative current sources when facts, numbers, policies, market data, company data, or public figures may have changed.
    • Prefer primary sources: official statistics, filings, annual reports, central bank or government data, academic papers, standards, product docs, and direct company materials.
    • Use secondary media only to contextualize or compare interpretations.
    • Cite sources with Markdown links.
  6. Check "逻辑三洽".

    • 自洽: Definitions, assumptions, and causal chains do not contradict each other.
    • 他洽: The thesis can explain the source article's valid observations, important counterexamples, and known external facts.
    • 续洽: The thesis can generate future observable signals. If time-based proof is not possible, use derivation-style reasoning and list future signals that would confirm or falsify the thesis.
  7. Write the final Markdown article and save it.

    • Create or reuse markdown/ under the current project.
    • Save the file with a descriptive slug and date when useful.
    • Write a clean standalone article. Do not include sections named "旧文真正说了什么", "旧逻辑的关键漏洞", "如果基石假设崩塌", "逻辑三洽检验", or similar analysis scaffolding unless the user explicitly asks for an audit-style output.
    • Treat the source article as internal raw material. Do not write "原文认为", "原文提到", "原文实验说明", "旧文指出", "作者说", "source article", or similar phrases in the final article unless the user asks for an audit, critique, or comparison.
    • Include at least one useful visual. Prefer one Mermaid diagram for structure or flow. Add inline SVG only when it explains a concept better than text or Mermaid; do not add decorative visuals.
    • Keep the article compact. For ordinary blog/news rewrites, target about 900-1,600 Chinese characters of body text before references unless the user asks for a long article.
Show full SKILL.md (223 more words)Show less

Output Structure

Use this compact standalone structure by default:

markdown
# [鲜明的新标题]

> [一句话核心判断。]

## [重点一:直接进入最重要的新判断]

[Explain the mechanism and cite evidence.]

```mermaid
flowchart LR
  A["关键变化"] --> B["机制"]
  B --> C["影响"]
```

## [重点二:展开关键案例或能力]

[Explain what changed and why it matters.]

## [重点三:落到边界、风险或生产含义]

[Keep caveats concrete. Do not over-explain.]

## 接下来该看什么

[List 3-6 observable signals.]

## 结论

[Memorable synthesis.]

## 参考来源

- [Source title](https://...)

Writing Requirements

  • Keep the new article higher-level than the source: more abstract in mechanism, more concrete in evidence.
  • Use short, forceful section titles.
  • Make the article feel original and self-contained. Use the source as raw material, not as the visible structure or an object being summarized.
  • Avoid explicit "old article vs new article" framing unless the user asks for critique, audit, or deconstruction. Do not narrate how the source article argued; present the rebuilt thesis directly.
  • Keep scope tight. Prefer 2-4 strong sections over exhaustive coverage.
  • Highlight the central point early, then support it with the fewest necessary facts and cases.
  • Prefer direct declarative framing over forced binary contrast. Titles, subtitles, blockquotes, and section headings should usually state the new judgment directly, such as "DuckDB 正式将 AI 向量检索变成一等公民".
  • Avoid "不是...而是..." by default. Use it only when a genuine misconception must be corrected and a direct sentence would be weaker; never use it as a habitual narrative template.
  • Explain concepts enough for an intelligent non-specialist without diluting the argument.
  • Avoid generic rewrites, moralizing, empty trend language, and unsourced data.
  • Do not fabricate article content, data, citations, cases, or quotes.
  • When evidence is uncertain, say what is known, what is inferred, and what would need verification.
  • End with references, but keep the bibliography concise and relevant.

© digoal, GPL-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 1 other file in skills/higher-order-article-writer of digoal/blog.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit ad6fcb7

Compare with similar skills

Higher Order Article Writer 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.

Higher Order Article Writer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Higher Order Article Writer this skilldigoal/blog8.6k—~1.7kAutomated safety check: PassGPL-2.0
Markdown Article FormatterJimLiu/baoyu-skills26k6 repos~3.5kAutomated safety check: PassMIT
MarkitdownImCa0/just-laws78214 repos~3.2kAutomated safety check: NotesMIT
Obsidian MarkdownAtmosphere/atmosphere3.8k20 repos~1.3kAutomated safety check: PassApache-2.0
DOCXrvdbreemen/OTGW-firmware20733 repos~4.3kAutomated safety check: PassProprietary
Gzh Designisjiamu/gzh-design-skill3.9k1 repos~2.2kAutomated safety check: PassAGPL-3.0

Similar skills

  • Markdown Article Formatter

    JimLiu/baoyu-skills

    Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.

    26k GitHub starsUsed in 6 repos~3.5k tokens
    Documents & OfficeAuto-check passed
  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    782 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • DOCX

    rvdbreemen/OTGW-firmware

    A skill your agent uses whenever the user wants to create, read, edit, or manipulate Word documents (.docx files).

    207 GitHub starsUsed in 33 repos~4.3k tokens
    Documents & OfficeAuto-check passed
  • Gzh Design

    isjiamu/gzh-design-skill

    微信公众号文章排版引擎,将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取,自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入(非 Markdown…

    3.9k GitHub starsUsed in 1 repo~2.2k tokens
    Documents & OfficeAuto-check passed
  • Reads, creates and edits Word .docx files with python-docx, and drops to raw OOXML for tracked changes, comments and byte-exact edits.

    41k GitHub stars~2.5k tokensUpdated yesterday
    Documents & OfficeAuto-check passed

More from digoal/blog

All 98 skills in this repo
  • 三层审查模型,逐段逐句验证文章真伪、证据链与逻辑结构。Use when the user asks to fact-check, verify, audit, or evaluate the credibility of an article, essay, report, opinion piece, social-media post, or any written claim —…

    8.6k GitHub stars~939 tokensUpdated today
    Auto-check passed
  • Find latent bugs in a local PostgreSQL source tree (RELxxSTABLE branch or HEAD) the way a core hacker does: build a heavily-poisoned debug instance (cassert + cache-discard + -O0/-ggdb3 + core…

    8.6k GitHub stars~4k tokensUpdated today
    Auto-check passed
  • Digoal

    digoal/blog

    Portable digital employee distilled from digoal's personal blog for PostgreSQL, PolarDB, DuckDB, AI+database, vector/RAG, database operations, source-code reading, technical content creation…

    8.6k GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • 从论文 PDF 文件或论文 PDF URL 生成通俗易懂、图文并茂、带批判性评估的中文 Markdown 解读,并保存到当前项目的 markdown 目录。Use when the user asks to interpret,精读,解读,summarize,explain,analyze, or write an article from an academic paper PDF…

    8.6k GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Analyze a product from documentation, websites, PDFs, articles, release notes, pricing pages, app listings, reviews, filings, or related links; save separate intermediate analyses from seven roles…

    8.6k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Turn a blog post, article, notes, or any source material into a set of vertical poster images — one cover plus several coherent content slides that explain the core points.

    8.6k GitHub stars~1.4k tokensUpdated today
    Auto-check passed

Questions about Higher Order Article Writer

What does Higher Order Article Writer do?

Read a provided URL, local file, or pasted article, digest its core claims and assumptions, rebuild the topic into a concise original source-backed Chinese Markdown article, and save it under the…. Higher Order Article Writer is an agent skill from digoal/blog. Read a provided URL, local file, or pasted article, digest its core claims and assumptions, rebuild the topic into a concise original source-backed Chinese Markdown article, and save it under the current project's markdown directory.

When should I use Higher Order Article Writer?

Higher Order Article Writer fits situations like: the user asks to upgrade; produce a higher-order article from an existing article.

How do I install Higher Order Article Writer in Claude Code?

Run `npx skills add digoal/blog --skill higher-order-article-writer -a claude-code`. Or copy the skill folder (skills/higher-order-article-writer in digoal/blog) into .claude/skills/higher-order-article-writer in your project. Claude Code loads it when a task matches its description.

How do I install Higher Order Article Writer in Codex?

Run `npx skills add digoal/blog --skill higher-order-article-writer -a codex`. Or copy the skill folder (skills/higher-order-article-writer in digoal/blog) into .agents/skills/higher-order-article-writer in your project. Codex loads it when a task matches its description.

Can I use Higher Order Article Writer 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 digoal/blog --skill higher-order-article-writer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/higher-order-article-writer, .gemini/skills/higher-order-article-writer, .github/skills/higher-order-article-writer and .opencode/skills/higher-order-article-writer in your project.

What does Higher Order Article Writer need to run?

SKILL.md names no scripts, command-line tools or credentials: Higher Order Article Writer is instructions for the agent only.

Does Higher Order Article Writer 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 Higher Order Article Writer 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 Higher Order Article Writer use?

Higher Order Article Writer is published under the GPL-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Higher Order Article Writer use?

About 1.7k tokens (SKILL.md is roughly 6.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 Higher Order Article Writer?

Skills that share tags, products or a category with Higher Order Article Writer: Markdown Article Formatter (JimLiu/baoyu-skills, 26k stars), Markitdown (ImCa0/just-laws, 782 stars), Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars) and DOCX (rvdbreemen/OTGW-firmware, 207 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Higher Order Article Writer?

digoal (a GitHub user) maintains it in digoal/blog, which has 8,586 GitHub stars. The repository holds 98 skills in this directory. The repository was last updated on October 9, 2026.

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