Agent skill

Humanities Writing Companion

by tizzy916 in tizzy916/humanities-writing-companion

Help with humanities scholarly writing: sharpen research questions, map supplied readings, plan and draft arguments, review chapters, preserve authorial voice, and respond to reviewers.

CC-BY-NC-4.0Auto-check passedWriting & Content

Install Humanities Writing Companion

skills CLI
$ npx skills add tizzy916/humanities-writing-companion --skill humanities-writing-companion -a claude-code

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

GitHub CLI
$ gh skill install tizzy916/humanities-writing-companion humanities-writing-companion --agent claude-code

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

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
humanities-writing-companion
GitHub stars
436
Token cost
~3.4k tokens
SKILL.md length
1,648 words
Files
78 (incl. scripts, references)
Skills in repo
1
Repo updated
First seen
Licence
CC-BY-NC-4.0

At a glance

Help with humanities scholarly writing: sharpen research questions, map supplied readings, plan and draft arguments, review chapters, preserve authorial voice, and respond to reviewers.

  • Works in 4 steps: Read the supplied text and request.… → Match scope: a sentence edit gets an… → Select the relevant mode below. Read… → …
  • Related argumentative scholarship
  • SKILL.md covers Start with the requested outcome, Authorial control and evidence, Task router and Four-layer critique, plus 3 more sections
  • Runs Python scripts from its folder; calls python3

What it does

Humanities Writing Companion is an agent skill from tizzy916/humanities-writing-companion. Help with humanities scholarly writing: sharpen research questions, map supplied readings, plan and draft arguments, review chapters, preserve authorial voice, and respond to reviewers. Use for history, philosophy, literature, and related argumentative scholarship, including 论文、改论文、文献综述、审稿意见、我手写我口, or “review this paragraph” when an academic draft is in context. Not for unrelated copywriting or a standalone literature-search pipeline.

Its SKILL.md is about 3.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 80 other files, including scripts and reference files (for example `.github/ISSUE_TEMPLATE/bug-report.yml`, `.github/ISSUE_TEMPLATE/config.yml` and `.github/ISSUE_TEMPLATE/feature-request.yml`).

It sits in Writing & Content, covering Hypothesis generation, Copywriting and Literature review. The repository describes itself as: End-to-end humanities writing assistant — an Agent Skill (open SKILL.md format). 11 modes from Socratic research-question sharpening through AI-use disclosure. Bilingual (EN/中文)…

When your agent uses it

  • Related argumentative scholarship
  • Including 论文、改论文、文献综述、审稿意见、我手写我口
  • Review this paragraph when an academic draft is in context

Example prompts

  • “review this paragraph”
  • “/humanities-writing-companion”

Requirements

  • Python 3

Workflow steps

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

  1. Read the supplied text and request. Infer language, discipline, genre, and stage when the evidence permits. Missing profiles do not block…
  2. Match scope: a sentence edit gets an edit; a full review gets a complete report; coaching gets dialogue. Do not turn a short passage into…
  3. Select the relevant mode below. Read only its references and the discipline entries needed for this task. Mode G bypasses…
  4. Finish with the requested deliverable, what changed or was found, and material evidence gaps. Do not claim to have checked unseen…

What it can do on your machine

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

    Ships 1 file in scripts/ (Python, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    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

Humanities Writing Companion loads about 3.4k tokens when it runs, and up to ~78k if it reads all its reference files. Until then it costs about 117 tokens; SKILL.md has 1,648 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~117
When it runs · the whole SKILL.md, loaded when a task matches
~3.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~78k

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); the scripts in this folder are not scanned.

SKILL.md

Its licence (CC-BY-NC-4.0) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,648 words (~3,424 tokens).

“Help the author think and write in their own voice. In humanities scholarship, prose carries conceptual distinctions, interpretation, and argument; editing must preserve those commitments, not merely smooth the language.”

— opening of SKILL.md by tizzy916, CC-BY-NC-4.0
name
humanities-writing-companion

Read the full SKILL.md on GitHub

Files

SKILL.md and 77 other files (scripts, references) in the repository root of tizzy916/humanities-writing-companion.

  • SKILL.md
  • .github/ISSUE_TEMPLATE/bug-report.yml
  • .github/ISSUE_TEMPLATE/config.yml
  • .github/ISSUE_TEMPLATE/feature-request.yml
  • .github/ISSUE_TEMPLATE/skill-question.yml
  • .github/check_skill.py
  • .github/workflows/ci.yml
  • .gitignore
  • .zenodo.json
  • CHANGELOG.md
  • CITATION.cff
  • CONTRIBUTING.md
  • CONTRIBUTING.zh.md
  • LICENSE
  • README.md
  • README.zh.md
  • SKILL.zh.md
  • docs
  • … and 60 more

Open the folder on GitHubat commit e097ff6

Compare with similar skills

Humanities Writing Companion 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.

Humanities Writing Companion compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Humanities Writing Companion this skilltizzy916/humanities-writing-companion436—~3.4kAutomated safety check: PassCC-BY-NC-4.0
Natural Chinesegarden-cosmos/natural-chinese-protocol143—~1.4kAutomated safety check: PassMIT
Typst Paperbahayonghang/academic-writing-skills500—~3.6kAutomated safety check: PassNone
Bilingual Paper ReaderYuan1z0825/nature-skills47k—~961Automated safety check: PassApache-2.0
Humanize Koreansangrokjung/claude-forge852—~1.3kAutomated safety check: PassMIT
Med Cultureasgard-ai-platform/skills242—~4.2kAutomated safety check: PassMIT

Similar skills

  • Natural Chinese

    garden-cosmos/natural-chinese-protocol

    A skill your agent uses whenever generating or rewriting Chinese text that needs to sound natural and human-written.

    143 GitHub stars~1.4k tokensUpdated 3 mo ago
    Writing & ContentAuto-check passed
  • Typst Paper

    bahayonghang/academic-writing-skills

    Typst paper assistant for existing .typ manuscripts in English or Chinese.

    500 GitHub stars~3.6k tokensUpdated 13 days ago
    Documents & OfficeAuto-check passed
  • Bilingual Paper Reader

    Yuan1z0825/nature-skills

    Creates a source-grounded Chinese-English reader for a research paper, with aligned text, figures, tables and equations, or answers questions about a given passage.

    47k GitHub stars~961 tokensUpdated today
    Research & ScienceAuto-check passed
  • Humanize Korean

    sangrokjung/claude-forge

    Clean up translation-ese and AI-writing tics in Korean prose so it reads like a person wrote it — content (facts, numbers, proper nouns, quotes) stays 100% unchanged, only style and rhythm are…

    852 GitHub stars~1.3k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Med Culture

    asgard-ai-platform/skills

    A skill your agent uses when the user wants to write a culture-and-arts news piece — exhibition coverage, performance reviews, artist interviews, cultural policy analysis, art market reporting, or…

    242 GitHub stars~4.2k tokensUpdated 4 mo ago
    Writing & ContentAuto-check passed
  • Translation

    seb1n/awesome-ai-agent-skills

    Translate text between languages with cultural adaptation, terminology consistency, and support for multiple document types including technical docs, marketing copy, and UI strings.

    206 GitHub stars~1.9k tokensUpdated 2 mo ago
    Writing & ContentAuto-check passed

Questions about Humanities Writing Companion

What does Humanities Writing Companion do?

Help with humanities scholarly writing: sharpen research questions, map supplied readings, plan and draft arguments, review chapters, preserve authorial voice, and respond to reviewers. Humanities Writing Companion is an agent skill from tizzy916/humanities-writing-companion. Help with humanities scholarly writing: sharpen research questions, map supplied readings, plan and draft arguments, review chapters, preserve authorial voice, and respond to reviewers.

When should I use Humanities Writing Companion?

Humanities Writing Companion fits situations like: related argumentative scholarship; including 论文、改论文、文献综述、审稿意见、我手写我口; review this paragraph when an academic draft is in context.

How do I install Humanities Writing Companion in Claude Code?

Run `npx skills add tizzy916/humanities-writing-companion --skill humanities-writing-companion -a claude-code`. Or copy the skill folder (the tizzy916/humanities-writing-companion repository) into .claude/skills/humanities-writing-companion in your project. Claude Code loads it when a task matches its description.

How do I install Humanities Writing Companion in Codex?

Run `npx skills add tizzy916/humanities-writing-companion --skill humanities-writing-companion -a codex`. Or copy the skill folder (the tizzy916/humanities-writing-companion repository) into .agents/skills/humanities-writing-companion in your project. Codex loads it when a task matches its description.

Can I use Humanities Writing Companion 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 tizzy916/humanities-writing-companion --skill humanities-writing-companion -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/humanities-writing-companion, .gemini/skills/humanities-writing-companion, .github/skills/humanities-writing-companion and .opencode/skills/humanities-writing-companion in your project.

What does Humanities Writing Companion need to run?

Going by SKILL.md and its folder, Humanities Writing Companion needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Humanities Writing Companion 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 Humanities Writing Companion 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Humanities Writing Companion use?

Humanities Writing Companion is published under the CC-BY-NC-4.0 licence (from the LICENSE file in the skill folder).

How many tokens does Humanities Writing Companion use?

About 3.4k tokens (SKILL.md is roughly 14k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 74k tokens, read only when the agent opens those files.

What are the alternatives to Humanities Writing Companion?

Skills that share tags, products or a category with Humanities Writing Companion: Natural Chinese (garden-cosmos/natural-chinese-protocol, 143 stars), Typst Paper (bahayonghang/academic-writing-skills, 500 stars), Bilingual Paper Reader (Yuan1z0825/nature-skills, 47k stars) and Humanize Korean (sangrokjung/claude-forge, 852 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Humanities Writing Companion?

tizzy916 (a GitHub user) maintains it in tizzy916/humanities-writing-companion, which has 436 GitHub stars. The repository was last updated on September 22, 2026.

Source: tizzy916/humanities-writing-companion on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.