proposal-write

proposal-write is a skill for Claude Code from hutzelmann/thesis-proposal-skills. It costs 52 tokens per session (3,081 once invoked), scanned A, original, MIT.

A writing tool for creating or revising a thesis proposal, the document that explains planned research before the work begins. It bases claims on existing research literature.

In plain words
What is it for?
Use it to draft a proposal from a seed file, improve its prose, or revise it in response to feedback. It produces a single Markdown file with proposal text and reference metadata.
Why use it?
It turns starting notes, bullet points, drafts, or review comments into a consistent proposal while keeping claims tied to references. This reduces the work of shaping research ideas into formal sections.

Skill for Claude Code

Written for Claude Code: ${CLAUDE_SKILL_DIR} variable.

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/hutzelmann/thesis-proposal-skills/proposal-write
Any agent
npx skills add hutzelmann/thesis-proposal-skills --skill proposal-write
Clone the repo
git clone --depth 1 https://github.com/hutzelmann/thesis-proposal-skills

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for proposal-write

README.md
[![agentmods](https://agentmods.dev/badge/skills/hutzelmann/thesis-proposal-skills/proposal-write.svg)](https://agentmods.dev/skills/hutzelmann/thesis-proposal-skills/proposal-write)
Your own site
<a href="https://agentmods.dev/skills/hutzelmann/thesis-proposal-skills/proposal-write"><img src="https://agentmods.dev/badge/skills/hutzelmann/thesis-proposal-skills/proposal-write.svg" alt="Measured on agentmods" height="20"></a>
Per session 52 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,081 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00052 $0.03081
Opus 5 $0.00026 $0.01541
Sonnet 5 $0.00010 $0.00616
Haiku 4.5 $0.00005 $0.00308

Measured yesterday against content hash df9cd21d539c, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

proposal-write scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/check.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/proposal-write/SKILL.md · 106 lines

How it starts

The opening of the file, as written. The whole thing — 106 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Proposal Write

Produces the actual proposal text — a first draft from a seed file, sharper prose from bullet points, or a revision that works through a review's findings one by one, with every claim tied to something in the literature.

Workflow: proposal-ideate → proposal-lit-search → proposal-write → proposal-check → proposal-review → proposal-publish. Also: proposal-import (start from an existing document), proposal-reverse (derive a proposal from a finished thesis), proposal-customize (adapt the rules to a supervisor's requirements), proposal-supervise (supervisor-side feedback on a raw submission), proposal-troubleshoot (diagnose a skill that misbehaved).

Voice: neutral and constructive — never praise the user or their material, never compliment your own output. Chat messages stay short and precise; findings are stated plainly, with the next step when one exists.

You write and refine thesis proposals in the single-file format: a leading # <title> line as the file's only H1, the subtitle as an emphasized *…* paragraph beneath it, the canonical sections at ##, a closing references heading, and a trailing --- metadata block (references in CSL-YAML), preceded by a blank line. Proposals are anonymous: no author key, no writer name in the text.

Execution shape

One writer per file: you draft the sections in sequence, apply a review's findings item by item, and run the density pass over the whole file, all in this one context — never one helper agent per section or per finding, because parallel edits to the same file break the surgical-edit rule, the (RQn) cross-references and the whole-file density pass.

Ground rules

Read references/guidelines.md first — it is the authority on structure, research-question quality, methodology content, citations, and writing style. If the workspace contains a guidelines.md, its TOML block and prose override the defaults (per-key wins, lists replace, forbidden sections may be allowed again).

Read the full file on GitHub · 106 lines

Files

What ships with it

4 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday Changed · +6 lines df9cd21d539c
  2. 5d ago First seen · 100 lines · 52 tokens per session scan A fb433ec90431

Subscribe to this mod's changes

proposal-write is a skill published in the GitHub repository hutzelmann/thesis-proposal-skills (7 stars, last pushed 3d ago), licensed MIT. It adds 52 tokens to every session and 3,081 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

lore

SpecStory Lore - mine your SpecStory coding histories (any agent - Claude Code, Codex, Cursor, Gemini, and more) into a persistent corpus, surface your reproducible workflows with corroborated evidence, and interactively forge the chosen ones into skills installed across all your agent harnesses. Use when the user…

specstoryai/getspecstory · 109 tokens

docs-manage

Manage the Grounded Docs MCP Server documentation index. Covers scraping and indexing documentation from URLs or local files, refreshing existing indexes with changed content, and removing libraries from the index. Use when you need to add, update, or delete indexed documentation.

arabold/docs-mcp-server · 53 tokens

docs-search

Search and query the Grounded Docs MCP Server documentation index. Covers listing indexed libraries, searching documentation content, and resolving library versions. Use when you need to look up API references, find code examples, or check which documentation is available in the local index.

arabold/docs-mcp-server · 54 tokens

workthreads

SpecStory Workthreads - a weekly work-thread rollup across a team's repos from SpecStory coding histories (any agent - Claude Code, Codex, Cursor, Gemini, and more). It groups the window's sessions into threads of work per project and labels each new / open / recently closed, so a lead sees what shipped, what is still…

specstoryai/getspecstory · 126 tokens

fetch-url

Fetch a single URL and convert its content to Markdown. Use when you need to read a web page, documentation page, or API reference without indexing it. The content is returned as plain Markdown text on stdout.

arabold/docs-mcp-server · 45 tokens

backseat-driver-testing

Testing strategies for Calva Backseat Driver MCP tools. Use when: Testing Backseat Driver, validating tool updates, testing structural editing workflows, verifying REPL evaluation with who-tracking, testing shadow-cljs runtime discovery and targeting, testing output log filtering, testing load-file tool, smoke testing…

BetterThanTomorrow/calva-backseat-driver · 106 tokens