thesis-proposal-skills: Instructions file for Claude Code

AGENTS.md

thesis-proposal-skills AGENTS.md is an instructions file for Claude Code, Codex, OpenCode from hutzelmann/thesis-proposal-skills. It costs 4,663 tokens per session, scanned C, original, MIT.

A repository guide for ten agent skills that help students write thesis proposals, including a supervisor-focused skill. It defines a specification-first development process and rules for keeping real proposals and credentials private.

In plain words
What is it for?
Use it when developing, testing, or documenting thesis-proposal skills and validating their specifications.
Why use it?
It tells agents how to change and test the skills while protecting users’ proposal files and following the project’s required review process.

Instructions file for Claude CodeCodexOpenCode

Written for Claude Code and Codex and OpenCode: ${CLAUDE_SKILL_DIR} variable, but also the file is AGENTS.md. Also seen: reads .claude/ paths; mentions AGENTS.md.

This is hutzelmann/thesis-proposal-skills's own configuration. It tells Claude Code, Codex and OpenCode how to work on thesis-proposal-skills itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything thesis-proposal-skills configures →

Reuse

Borrowing it

Nothing to install: this file belongs to hutzelmann/thesis-proposal-skills. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/hutzelmann/thesis-proposal-skills/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/hutzelmann/thesis-proposal-skills

Made for: Claude Code, Codex, OpenCode.

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 thesis-proposal-skills AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/hutzelmann/thesis-proposal-skills/agents-md.svg)](https://agentmods.dev/instructions/hutzelmann/thesis-proposal-skills/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/hutzelmann/thesis-proposal-skills/agents-md"><img src="https://agentmods.dev/badge/instructions/hutzelmann/thesis-proposal-skills/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 4,663 This file is loaded in full into every session.
When invoked 4,663 The same file — it is already loaded in full.
Security scan C 1 finding. 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.04663 $0.04663
Opus 5 $0.02331 $0.02331
Sonnet 5 $0.00933 $0.00933
Haiku 4.5 $0.00466 $0.00466

Measured 2d ago against content hash 146fa973104f, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade C, and why

thesis-proposal-skills AGENTS.md scanned grade C with 1 finding 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 2d ago.

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.

Recursive force deletehighDestructive command

rm -rf with a variable or a broad path is one typo away from removing the wrong tree.

**Use the OpenSpec tooling; never hand-roll it.** Humans enter the loop through the `/opsx:*` slash commands (`/opsx:propose`, `/opsx:apply`, `/opsx:archive`). Agents invoke the matching skills instead — `openspec-propos
AGENTS.md · 174 lines

How it starts

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

AGENTS.md

Instructions for AI agents working on this repository (skill development and testing). User-facing proposal guidance lives in shared/guidelines/guidelines.md and is a product artifact, not agent instructions.

What this repo is

thesis-proposal-skills: ten proposal-* agent skills (under skills/) that help students write thesis proposals — nine student-side, plus the supervisor-side proposal-supervise — and the machinery to test them. Users install the skills into their own workspace; their proposals never live here. Real proposals sit in a private local directory kept out of version control via .git/info/exclude — never commit, copy, quote, or name its contents. Developer credentials live in the gitignored .env (template: .env.example), never beside the real proposals.

Spec-first workflow (mandatory)

openspec/specs/ is the source of truth, managed with OpenSpec. Any behavior change runs the loop: propose (change folder with proposal, spec deltas, tasks) → human review → implement → archive. Pure refactors/tooling/docs set skip_specs: true in the change's .openspec.yaml. Validate with openspec validate --all --strict. Agent integration files under .claude/ are regenerated with openspec init --tools <agent> and are not committed — except .claude/settings.json, which a .gitignore exception keeps tracked.

Use the OpenSpec tooling; never hand-roll it. Humans enter the loop through the /opsx:* slash commands (/opsx:propose, /opsx:apply, /opsx:archive). Agents invoke the matching skills instead — openspec-propose, openspec-apply-change, openspec-archive-change, openspec-update-change, openspec-sync-specs, openspec-explore — which carry their own allowed-tools: Bash(openspec:*) grant. Inside them, drive the CLI: openspec new change, openspec instructions <artifact>, openspec status --change <id>, openspec archive. Never create, move, or delete a change folder by hand (mkdir -p openspec/changes/…, mv … openspec/changes/archive/…, rm -rf …/specs/…), and never hand-write an artifact the CLI would scaffold.

Read the full file on GitHub · 174 lines

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. 2d ago Changed · +2 lines · +308 tokens per session 146fa973104f
  2. 6d ago First seen · 172 lines · 4,355 tokens per session scan C c771afcec7fe

Subscribe to this mod's changes

thesis-proposal-skills AGENTS.md is an instructions file published in the GitHub repository hutzelmann/thesis-proposal-skills (7 stars, last pushed 3d ago), licensed MIT. It adds 4,663 tokens to every session, about $0.0233 per session on Opus 5. A static security scan graded it C with 1 finding (recursive force delete). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.