All skills

Cryptography Writing

Community builtSKILL.md

Draft or minimally edit cryptography manuscripts: definitions, theorem statements, security arguments, abstracts, and technical overviews.

Install
npx skills add https://github.com/ziyang-theory/cryptography-research-skills
About

Draft or minimally edit cryptography manuscripts, including definitions, theorem statements, security arguments, abstracts, and technical overviews. Preserve the construction and guarantee; use crypto-proof-auditor for substantive proof-validity review.

Links
Tags
cryptography-writing · community · ziyang-theory
SKILL.md

Cryptography Writing

Make the contribution and argument precise and readable. Use established terms when they express the intended formal meaning; otherwise name the object or relationship plainly. Theory-only writing needs no implementation or experiments.

Prefer concrete cryptographic nouns and operations over generic labels such as “endpoints,” “layer,” “interface,” “publish,” or “pad.” Name the parties, OT roles, protocol phase, primitive, PRF outputs, messages, broadcast, or reconstruction actually meant. Prefer “corrupted parties” to “coalition” when describing the corrupted set, and name supplied correlations rather than calling them “scalar correlations” or “OT state.” Explain what is sampled or causes an abort instead of relying on “marginal” or “cutoff” alone.

For drafting or terminology revision, use the wording defaults in terminology. They express preferred prose, not claims that the avoided words are unknown in cryptography. Preserve exact mathematical distinctions, formal interfaces, complete retained state, source-defined terms, and technically meaningful uses such as “one-time pad.” Local author instructions can override these defaults.

Work from the active claim

Check project guidance for the author's explicit wording corrections and accepted replacements. Preserve their scope and later reverts. When an existing term already names the intended object, prefer it to inventing and defining another label; a terminology question alone does not authorize manuscript edits.

  1. Resolve the requested source version and active text. Read the relevant definitions, notation, theorem, and nearby argument before changing a technical claim.
  2. Identify what the sentence relies on: the experiment or functionality, adversary and corruption, setup and oracle access, quantifiers and bounds, assumptions, composition, leakage, and output guarantee. State the material conditions or point to a definition fixing them; do not repeat the whole model in every sentence.
  3. Distinguish the intended target, the theorem stated, the reasoning supplied, and any implemented variant. Draft only what the available material supports; never invent a citation, proof step, assumption, or result.
  4. Match the work to the request. Reviewing or suggesting wording does not authorize file edits. For authorized edits, preserve unrelated changes and make the smallest technically correct repair unless a rewrite is requested. Keep notation, macros, labels, comments, wrapping, and the author's voice.
  5. Check the resulting claim against its sources and inspect the diff. Follow applicable manuscript checks when editing source files. If a repair requires a new model, theorem, or authorial choice, report the ambiguity and a narrow alternative rather than silently changing it.

Local definitions take precedence over generic terminology. Keep correctness, security, and implementation evidence distinct; likewise joint distributions versus marginals, success probability versus advantage, concrete versus asymptotic bounds, and ideal-resource guarantees versus concrete instantiations. A stylistic edit cannot establish a missing theorem.

Load details only for the current task

Use the entrypoint alone for a straightforward grammar edit with fixed meaning. For drafting or terminology changes, use the terminology reference above; read other references only for the relevant task:

TaskReference
Abstract/introduction structure or consistency with a technical overviewAbstracts and introductions
Explain a construction or proof ideaTechnical overviews
Preferred wording, an ambiguous cryptographic word, or a claim verbTerminology
Security statements, experiments, reductions, or full proofsSecurity claims
MPC, simulation, corruption, composition, or output guaranteesSecure computation
Proof systems, extraction, commitments, or oracle modelsProof systems and oracles
Construction interfaces, preprocessing, rounds, or costsConstructions and costs
Mixed edit authorization or multiple manuscript variantsConservative editing

The narrative guides link optional source examples; those corpora are not required reading. Load multiple references only when the claim actually crosses their topics.

Full proof drafting

For a new simulation-based proof or an authorized substantial rewrite, a useful default is to describe the simulator's information, interfaces, state, and behavior, then justify meaningful real-to-ideal transitions and accumulate their bounds. Preserve the complete joint view and conditional distributions, including for perfect security. A direct equality-of-distributions argument can suffice; do not invent intermediate experiments or impose particular labels. Follow the governing definition and the author's organization when another presentation is clearer.

A requested substantive validity audit or proof completion may need crypto-proof-auditor; source/PDF verification may need crypto-manuscript-qa. Use companions only for those additional tasks, not automatically during prose editing. Deliver the prose or minimal patch, with only material unresolved technical questions.

Related skills