tizzy916/humanities-writing-companion

contact_links:   - name: "💬 GitHub Discussions"     url: https://github.com/tizzy916/humanities-writing-companion/discussions

- name: "💬 GitHub Discussions"     url: https://github.com/tizzy916/humanities-writing-companion/discussions     about: "General discussion, usage tips, cross-discipline testing feedback — better suited to Discussions than Issues · 一般性讨论、使用

url: https://github.com/tizzy916/humanities-writing-companion/discussions

about: "General discussion, usage tips, cross-discipline testing feedback — better suited to Discussions than Issues · 一般性讨论、使用经验分享、跨学科测试反馈——这些更适合 Discussions 而非 Issues"   - name: "📖 SKILL.md — main documentation · 主文档"     url: https://git

- name: "📖 SKILL.md — main documentation · 主文档"     url: https://github.com/tizzy916/humanities-writing-companion/blob/main/SKILL.md     about: "Most usage questions are answered in SKILL.md's on-demand loading guide and quick-judgment sect

url: https://github.com/tizzy916/humanities-writing-companion/blob/main/SKILL.md

Executable file

run: sudo apt-get update && sudo apt-get install -y zsh

{       "scheme": "url",       "identifier": "https://github.com/tizzy916/humanities-writing-companion",

"scheme": "url",       "identifier": "https://github.com/tizzy916/humanities-writing-companion",       "relation": "isSupplementTo",

"identifier": "https://github.com/tizzy916/humanities-writing-companion",

],   "references": [     "Christou, P. A. (2026). Reconfiguring Reflexivity in the Era of AI: From 'Turning Back' to 'Looking Forward' Through Constructivist and Posthumanist Lenses. Qualitative Inquiry. https://doi.org/10.1177/107780042614

"references": [     "Christou, P. A. (2026). Reconfiguring Reflexivity in the Era of AI: From 'Turning Back' to 'Looking Forward' Through Constructivist and Posthumanist Lenses. Qualitative Inquiry. https://doi.org/10.1177/10778004261445052

"Christou, P. A. (2026). Reconfiguring Reflexivity in the Era of AI: From 'Turning Back' to 'Looking Forward' Through Constructivist and Posthumanist Lenses. Qualitative Inquiry. https://doi.org/10.1177/10778004261445052",

"Wiles, F. (2025). Recursive Cognition in Practice: How AI Dialogue Generated and Analyzed Its Own Methodology. International Journal of Qualitative Methods. https://doi.org/10.1177/16094069251381709",

"Panke, S. (2025). How Can (A)I Research This? An Autoethnographic Exploration of Generative AI in Research, Teaching and Instructional Design. https://doi.org/10.1177/00224871251325065"

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),

and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

- **Concept DOI corrected everywhere**: all "Concept DOI" references pointed to `10.5281/zenodo.20280773`, which is actually the **v4.1.1 version-specific DOI** — it permanently resolves to the v4.1.1 archive (old title, old repository name

- **Repository renamed**: `claude-skill-humanities-writing-companion` → `humanities-writing-companion` (GitHub redirects all old URLs). Every hardcoded repository URL updated: READMEs, CITATION.cff, .zenodo.json, docs/, issue-template confi

- **Positioning de-branded from Claude**: the skill is written in the open [Agent Skills](https://agentskills.io) (SKILL.md) format and is not Claude-only. Updated accordingly: README taglines and format badge, citation titles ("A Claude Sk

- `CITATION.cff` version bumped to 4.1.1 (single-line change; functionally identical to v4.1.0). - Published primarily to trigger the first archive event of the newly activated Zenodo↔GitHub integration, establishing the permanent Concept D

- Published primarily to trigger the first archive event of the newly activated Zenodo↔GitHub integration, establishing the permanent Concept DOI [10.5281/zenodo.20280772](https://doi.org/10.5281/zenodo.20280772) citable in papers that use 

- ARS's Concession Threshold pattern (Mode D anti-sycophancy) and overall design-influence remain credited in CITATION.cff (`references`) and in the SKILL.md Cross-Skill Collaboration section. This is a design-acknowledgment, not a license-

**License change: MIT → CC BY-NC 4.0.**

- License changed from MIT to CC BY-NC 4.0 (Creative Commons Attribution-NonCommercial 4.0 International).

- `## Showcase · Before / After` example demonstrating four-layer critique refusing to descend below a broken foundation. - `### Discipline routing protocol` in SKILL.md: discipline becomes a load-bearing routing variable. Onboarding step 1

- `### Discipline routing protocol` in SKILL.md: discipline becomes a load-bearing routing variable. Onboarding step 1 upgraded to enforce explicit discipline elicitation. - Citation section enhanced with proper BibTeX, plain-text attributi

- Citation section enhanced with proper BibTeX, plain-text attribution block, and "Citing companion tools" subsection for ARS attribution per its CC BY-NC 4.0 license.

alias: tizzy916     affiliation: "Tianyu Vision (TIANYU VISION); MA, History of Science, Tsinghua University"     website: "https://tianyu.art/"

affiliation: "Tianyu Vision (TIANYU VISION); MA, History of Science, Tsinghua University"     website: "https://tianyu.art/" abstract: >

website: "https://tianyu.art/"

- bilingual license: CC-BY-NC-4.0 repository-code: "https://github.com/tizzy916/humanities-writing-companion"

license: CC-BY-NC-4.0 repository-code: "https://github.com/tizzy916/humanities-writing-companion" url: "https://github.com/tizzy916/humanities-writing-companion"

repository-code: "https://github.com/tizzy916/humanities-writing-companion"

url: "https://github.com/tizzy916/humanities-writing-companion"

given-names: Cheng-I     title: "Academic Research Skills for Claude Code"     url: "https://github.com/Imbad0202/academic-research-skills"

title: "Academic Research Skills for Claude Code"     url: "https://github.com/Imbad0202/academic-research-skills"     license: "CC-BY-NC-4.0"

url: "https://github.com/Imbad0202/academic-research-skills"     license: "CC-BY-NC-4.0"     year: 2025

**Division of labor with academic-research-skills**: This skill does **not** handle the empirical research pipeline (literature search, data collection, methodological compliance, etc.) — that is the domain of [Imbad0202/academic-research-s

- ❌ **Making the skill more "general-purpose"** — e.g., adding a "general polishing mode" or extending it to empirical social science or STEM. The skill is deliberately opinionated (**humanities** + thought-first + voice-preserving) and doe

By contributing, you agree to release your contribution under the [CC BY-NC 4.0](LICENSE) license.

> **Note**: As of 2026-05-19, this project changed from MIT to CC BY-NC 4.0. New contributions fall under CC BY-NC 4.0 — meaning your contribution may also be used for non-commercial purposes only. If you have concerns about this, please op

**与 academic-research-skills 的分工**：本 skill 不做实证研究流水线（文献检索、数据收集、方法论合规等）——那是 [Imbad0202/academic-research-skills](https://github.com/Imbad0202/academic-research-skills) 的领地。本 skill 专注人文学科的写作声音、论证肌理、文风发展。在提议改动前请先确认它属于本 skill 的范围。

- ❌ **把 skill 变得更"通用"**——例如加一个"通用润色模式"、扩展到实证社科或 STEM。skill 故意有立场（**人文学科** + 思想优先 + 文风保持），不试图取悦所有写作场景。要做实证研究流水线请去 [academic-research-skills](https://github.com/Imbad0202/academic-research-skills)。

提交贡献即同意按 [CC BY-NC 4.0](LICENSE) 协议发布。

> **注意**:本项目自 2026-05-19 起从 MIT 改为 CC BY-NC 4.0。新贡献将归入 CC BY-NC 4.0 协议——这意味着你的贡献也只能用于非商业用途。如对此有顾虑请在 PR 前先开 Issue 讨论。

> An agent skill for humanities scholars whose primary deliverable is a long-form argumentative text — history, philosophy, literature, cultural studies, art history, religious studies, classics. Written in the open [Agent Skills](https://a

[![License: CC BY-NC 4.0](https://img.shields.io/badge/License-CC%20BY--NC%204.0-lightgrey.svg)](./LICENSE)

[![Skill format: Agent Skills](https://img.shields.io/badge/skill%20format-Agent%20Skills%20(SKILL.md)-orange)](https://agentskills.io)

[![Status: stable](https://img.shields.io/badge/status-stable-green)]()

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.20280772.svg)](https://doi.org/10.5281/zenodo.20280772)

[![Wiki](https://img.shields.io/badge/📖_Wiki-tutorials_%26_guides-blue)](https://github.com/tizzy916/humanities-writing-companion/wiki)

**[📖 Wiki](https://github.com/tizzy916/humanities-writing-companion/wiki)** · **[中文版 README](./README.zh.md)** · **[Skill source · English](./SKILL.md)** · **[Skill source · 中文](./SKILL.zh.md)**

git clone https://github.com/tizzy916/humanities-writing-companion.git \

git clone https://github.com/tizzy916/humanities-writing-companion.git \

No git required: on the [GitHub repository page](https://github.com/tizzy916/humanities-writing-companion), click **Code → Download ZIP**, unzip, and move the unzipped folder to `~/.claude/skills/humanities-writing-companion` (or `./.claude

This skill is written in the open [Agent Skills](https://agentskills.io) format: a folder containing `SKILL.md` plus plain-text `references/` and `scripts/`. Any agent that supports the format — or that can simply read `SKILL.md` (and, when

├── README.zh.md                      ← 中文 README ├── CHANGELOG.md                      ← Version history ├── LICENSE                           ← CC BY-NC 4.0

├── CHANGELOG.md                      ← Version history ├── LICENSE                           ← CC BY-NC 4.0 └── CITATION.cff                      ← Academic citation metadata

├── LICENSE                           ← CC BY-NC 4.0

version      = {5.1.0},   doi          = {10.5281/zenodo.20280772},   url          = {https://doi.org/10.5281/zenodo.20280772}

doi          = {10.5281/zenodo.20280772},   url          = {https://doi.org/10.5281/zenodo.20280772} }

url          = {https://doi.org/10.5281/zenodo.20280772}

Based on Humanities Writing Companion by Shen Cong https://github.com/tizzy916/humanities-writing-companion

https://github.com/tizzy916/humanities-writing-companion

If you also use [academic-research-skills](https://github.com/Imbad0202/academic-research-skills) in the same project, please cite both. ARS attribution format (per CC BY-NC 4.0):

Based on Academic Research Skills by Cheng-I Wu https://github.com/Imbad0202/academic-research-skills

https://github.com/Imbad0202/academic-research-skills

Shen Cong — BFA, Experimental Art, Central Academy of Fine Arts (CAFA); MA, History of Science, Tsinghua University (advisor: [Hu Yilin](https://yilinhut.net/author/admin)); Founder & CEO of [Tianyu Vision](https://tianyu.art/), a sci-art s

📮 [GitHub @tizzy916](https://github.com/tizzy916) · shencong916@gmail.com · Corrections, collaboration, and conversation welcome.

**[CC BY-NC 4.0](./LICENSE)** (Creative Commons Attribution-NonCommercial 4.0 International) — free for non-commercial use, modification, and distribution. Requires attribution.

> ⚠<U+FE0F> **License change (v3.0.0, 2026-05-19)**: This project relicensed from **MIT to CC BY-NC 4.0**. Versions ≤ v2.1.0 remain under MIT and retain their original commercial-use rights for those specific versions. From v3.0.0 onwards, **comme

This skill is licensed under CC BY-NC 4.0 — **non-commercial use only** (academic research, teaching, personal projects, open-source derivatives, internal research workflows).

- Christou, P. A. (2026). [Reconfiguring Reflexivity in the Era of AI](https://journals.sagepub.com/doi/10.1177/10778004261445052). *Qualitative Inquiry*.

- Wiles, F. (2025). [Recursive Cognition in Practice](https://journals.sagepub.com/doi/10.1177/16094069251381709). *International Journal of Qualitative Methods*.

- Panke, S. (2025). [How Can (A)I Research This?](https://journals.sagepub.com/doi/10.1177/00224871251325065).

- [Imbad0202/academic-research-skills](https://github.com/Imbad0202/academic-research-skills) — the upstream pipeline this skill complements; the Concession Threshold pattern in their reviewer module inspired Mode D's "minimum standard befo

- [Voice DNA + Audience Profile pattern](https://aiblewmymind.substack.com/p/claude-skills-ai-write-like-you) — inspired the style profile + reader profile pairing

- [Thesify](https://www.thesify.ai/) Purpose-Check — inspired Mode G blind reading

> 一个为人文学者设计的 agent skill，服务于以长篇论证性文本为主要交付物的写作——历史、哲学、文学、文化研究、艺术史、宗教学、古典学。采用开放的 [Agent Skills](https://agentskills.io)（SKILL.md）格式——Claude Code、Claude Agent SDK 以及任何支持该格式的 agent 都可以使用。

[![License: CC BY-NC 4.0](https://img.shields.io/badge/License-CC%20BY--NC%204.0-lightgrey.svg)](./LICENSE)

[![Skill format: Agent Skills](https://img.shields.io/badge/skill%20format-Agent%20Skills%20(SKILL.md)-orange)](https://agentskills.io)

[![Status: stable](https://img.shields.io/badge/status-stable-green)]()

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.20280772.svg)](https://doi.org/10.5281/zenodo.20280772)

[![Wiki](https://img.shields.io/badge/📖_Wiki-教程与指南-blue)](https://github.com/tizzy916/humanities-writing-companion/wiki)

**[📖 Wiki 教程](https://github.com/tizzy916/humanities-writing-companion/wiki)** · **[English README](./README.md)** · **[Skill 源文件 · 英文](./SKILL.md)** · **[Skill 源文件 · 中文](./SKILL.zh.md)**

git clone https://github.com/tizzy916/humanities-writing-companion.git \

git clone https://github.com/tizzy916/humanities-writing-companion.git \

无需 git：在 [GitHub 仓库页面](https://github.com/tizzy916/humanities-writing-companion) 点击 **Code → Download ZIP**，解压后把解压出的文件夹移动到 `~/.claude/skills/humanities-writing-companion`（项目级安装则放到 `./.claude/skills/humanities-writing-companion`），然后给 shell 脚

本 skill 采用开放的 [Agent Skills](https://agentskills.io) 格式：一个包含 `SKILL.md` 以及纯文本 `references/`、`scripts/` 的文件夹。任何支持该格式的 agent——或者只要能把 `SKILL.md`（及按需路由到的 `references/*.md`）读入上下文——都可以使用：把本仓库 clone 到你的 agent 发现 skills 的目录即可。`scripts/` 工具链需要 **zsh

├── README.zh.md                      ← 本文件 ├── CHANGELOG.md                      ← 版本历史 ├── LICENSE                           ← CC BY-NC 4.0

├── CHANGELOG.md                      ← 版本历史 ├── LICENSE                           ← CC BY-NC 4.0 └── CITATION.cff                      ← 学术引用元数据

├── LICENSE                           ← CC BY-NC 4.0

version      = {5.1.0},   doi          = {10.5281/zenodo.20280772},   url          = {https://doi.org/10.5281/zenodo.20280772}

doi          = {10.5281/zenodo.20280772},   url          = {https://doi.org/10.5281/zenodo.20280772} }

url          = {https://doi.org/10.5281/zenodo.20280772}

Based on Humanities Writing Companion by Shen Cong https://github.com/tizzy916/humanities-writing-companion

https://github.com/tizzy916/humanities-writing-companion

如果你在同一项目中同时使用了 [academic-research-skills](https://github.com/Imbad0202/academic-research-skills),请同时引用两者。ARS 的署名格式(遵循 CC BY-NC 4.0):

Based on Academic Research Skills by Cheng-I Wu https://github.com/Imbad0202/academic-research-skills

https://github.com/Imbad0202/academic-research-skills

沈聪,中央美术学院实验艺术学院本科,清华大学科学史系硕士(导师 [胡翌霖](https://yilinhut.net/author/admin)),科技文创公司 [天与视界 TIANYU VISION](https://tianyu.art/) 创始人 & CEO。

📮 [GitHub @tizzy916](https://github.com/tizzy916) · shencong916@gmail.com · 论文、合作、纠错欢迎来信

**[CC BY-NC 4.0](./LICENSE)**(知识共享 署名-非商业性使用 4.0 国际许可协议)——非商业用途自由使用、修改、分发,要求 attribution。

> ⚠<U+FE0F> **License change (v3.0.0, 2026-05-19)**:本项目从 **MIT 改为 CC BY-NC 4.0**。v2.1.0 及更早版本仍按 MIT 发布,保留原始商用权利(仅限这些特定版本)。从 v3.0.0 起,**未经单独授权禁止商业用途**。

本 skill 采用 CC BY-NC 4.0 协议——**仅限非商业用途**(学术研究、教学、个人项目、开源衍生、机构内部研究流程)。

- Christou, P. A. (2026). [Reconfiguring Reflexivity in the Era of AI](https://journals.sagepub.com/doi/10.1177/10778004261445052). *Qualitative Inquiry*.

- Wiles, F. (2025). [Recursive Cognition in Practice](https://journals.sagepub.com/doi/10.1177/16094069251381709). *International Journal of Qualitative Methods*.

- Panke, S. (2025). [How Can (A)I Research This?](https://journals.sagepub.com/doi/10.1177/00224871251325065).

- [Imbad0202/academic-research-skills](https://github.com/Imbad0202/academic-research-skills) — 本 skill 作为互补的上游流水线；他们的 reviewer 模块中的 Concession Threshold 模式启发了模式 D 的"让步前最低标准"

- [Voice DNA + Audience Profile 模式](https://aiblewmymind.substack.com/p/claude-skills-ai-write-like-you) — 启发了写作风格档案与目标读者档案的配对设计

- [Thesify](https://www.thesify.ai/) Purpose-Check — 启发了模式 G 盲读核对

Please use the following template to submit a cross-domain test report (open a new topic under [Discussions / Show and tell](https://github.com/tizzy916/humanities-writing-companion/discussions/categories/show-and-tell)):

请使用以下模板提交跨学科测试报告（在 [Discussions / Show and tell](https://github.com/tizzy916/humanities-writing-companion/discussions/categories/show-and-tell) 中开新主题）：

If you've read this far and find this set of positions acceptable, you are welcome to try the skill in your own writing. If you think one of the principles is wrong — especially if you think **the first principle** (thought before format) d

如果你读到这里，并且觉得这套立场可以接受，欢迎在自己的写作中尝试。如果你觉得某条原则不对——尤其是觉得**第一条原则**（思想优先于格式）在你的学科里不成立——请去 [Discussions / Ideas](https://github.com/tizzy916/humanities-writing-companion/discussions/categories/ideas) 反驳我。skill 的设计立场不是不可挑战的，但挑战需要在同一层级上发生（设计哲学层面），而不是

- [ ] Zenodo archive check: a new version appears under the Concept DOI       [10.5281/zenodo.20280772](https://doi.org/10.5281/zenodo.20280772), a version-specific DOI

[10.5281/zenodo.20280772](https://doi.org/10.5281/zenodo.20280772), a version-specific DOI

- [ ] Zenodo 归档核对：Concept DOI       [10.5281/zenodo.20280772](https://doi.org/10.5281/zenodo.20280772) 下出现新版本、

[10.5281/zenodo.20280772](https://doi.org/10.5281/zenodo.20280772) 下出现新版本、

访问 https://zenodo.org → 用 GitHub 账户登录（推荐，省去注册流程）。

**https://zenodo.org/account/settings/github/**

回到 https://zenodo.org/account/settings/github/，找到 `humanities-writing-companion` 行——会出现一个 DOI 链接（形如 `10.5281/zenodo.NNNNNNN`）。

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.NNNNNNN.svg)](https://doi.org/10.5281/zenodo.NNNNNNN)

version   = {v2.0.0},   doi       = {10.5281/zenodo.NNNNNNN},   url       = {https://doi.org/10.5281/zenodo.NNNNNNN}

doi       = {10.5281/zenodo.NNNNNNN},   url       = {https://doi.org/10.5281/zenodo.NNNNNNN} }

url       = {https://doi.org/10.5281/zenodo.NNNNNNN}

ORCID（https://orcid.org）是学术界的"作者唯一身份证"，绑定后 DOI 上你的作者身份会被全球唯一标识。建议绑定，但不绑也可以发布。

1. 打开 https://zenodo.org/account/settings/github/

6. **Optional: scholar-wendao integration**. If the author cites a specific scholar 3+ times and that scholar's framework is load-bearing for the argument, suggest:    > "I notice you cite Stiegler 5 times — his framework seems load-bearing

> "I notice you cite Stiegler 5 times — his framework seems load-bearing. Want to generate a `stiegler-perspective` skill via [scholar-wendao](https://github.com/tizzy916/scholar-wendao-skill) and use it as Reviewer X in Mode D?"

6. **可选:scholar-wendao 集成**。如果作者引用某学者 3+ 次且该学者框架是论证的承重墙,提议:    > "我注意到你引 Stiegler 5 次——他的框架是承重的。要不要用 [scholar-wendao](https://github.com/tizzy916/scholar-wendao-skill) 生成一个 `stiegler-perspective` skill,作为 Mode D 中的 Reviewer X 来压力测试?"

> "我注意到你引 Stiegler 5 次——他的框架是承重的。要不要用 [scholar-wendao](https://github.com/tizzy916/scholar-wendao-skill) 生成一个 `stiegler-perspective` skill,作为 Mode D 中的 Reviewer X 来压力测试?"

[Credential-related source omitted]

[Credential-related source omitted]

#!/usr/bin/env zsh

#!/usr/bin/env python3

#!/usr/bin/env python3

#!/usr/bin/env python3

API refs: https://api.crossref.org/works · https://api.openalex.org/works

CROSSREF_URL = "https://api.crossref.org/works"

OPENALEX_URL = "https://api.openalex.org/works"

USER_AGENT = "humanities-writing-companion/5.1.0 (https://github.com/tizzy916/humanities-writing-companion; mailto:shencong916@gmail.com)"

for attempt in range(retries + 1):         try:             req = urllib.request.Request(url, headers={"User-Agent": USER_AGENT})

try:             req = urllib.request.Request(url, headers={"User-Agent": USER_AGENT})             with urllib.request.urlopen(req, timeout=10) as resp:

req = urllib.request.Request(url, headers={"User-Agent": USER_AGENT})

with urllib.request.urlopen(req, timeout=10) as resp:

# OpenAlex throttles anonymous `.search` filters under heavy load;     # a free API key (optional) lifts that: https://openalex.org/rest-api

# a free API key (optional) lifts that: https://openalex.org/rest-api

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

container = src["display_name"]             doi = w.get("doi")             if doi and doi.startswith("https://doi.org/"):

doi = w.get("doi")             if doi and doi.startswith("https://doi.org/"):                 doi = doi[len("https://doi.org/"):]

if doi and doi.startswith("https://doi.org/"):

doi = doi[len("https://doi.org/"):]

#!/usr/bin/env bash

#!/usr/bin/env zsh

rm -f "$tmpfile"

#!/usr/bin/env python3

def check_responses(self, crossref, openalex):         def fetch(url):

def fetch(url):