# Edit > > - **Type:** Skill - **Install:** `agentstack add skill-ctx42-skills-edit` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [ctx42](https://agentstack.voostack.com/s/ctx42) - **Installs:** 0 - **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [ctx42](https://github.com/ctx42) - **Source:** https://github.com/ctx42/skills/tree/master/srd/skills/edit ## Install ```sh agentstack add skill-ctx42-skills-edit ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # edit Drive an existing SRD toward the SRD standard by editing the source in place. ## Boundaries The write-only editor of an existing SRD, applying changes one confirmed edit at a time — the counterpart to the read-only `review`. It must not invent or restate rules (defer all format, style, logic, and rules to `create`'s reference files), nor edit metadata (Owners, Initiative, Designs), set back-links, or change `Status` — only flag those gaps (STR-2..7, STA-*). Acceptance stays a human decision. It never writes `.review.md` — `review` owns that file across all modes; `edit` only reads it. ## Sources of truth The rules, checklist, procedures, template, and glossary live with `create`; reuse them, never duplicate. **This skill depends on `../create/references/*`, `../create/assets/*`, and `../create/scripts/*` — do not move or rename `create`. If any referenced file is missing at run time, stop and tell the user; do not proceed.** Read these before editing: - [../create/references/srd-standard.md](../create/references/srd-standard.md) (eager) — the rules (`STR`, `STA`, `LANG`, `REQ`, `GLO`, `SCO`, `MD`, Quality Bar). Every edit and check defers to these ids; re-validation checks against them directly. - [../create/references/authoring-guide.md](../create/references/authoring-guide.md) (eager) — house extensions (US English, sub-numbering, terminology consistency, the consistency pass) and the Bad→Good defect classes to fix toward. - [../create/references/srd-procedures.md](../create/references/srd-procedures.md) (on-demand: session start) — shared operating procedures (glossary resolution). - [../create/assets/srd-template.md](../create/assets/srd-template.md) (on-demand: restructuring) — the required section order. - [../create/scripts/glossary-fingerprint.sh](../create/scripts/glossary-fingerprint.sh) (run, not read) — hashes the shared glossary so its term digest is rebuilt only on change; the digest keeps term edits linking, not redefining. ## Documentation corpus (when available) Some setups expose the platform's live documentation over the `srd-doc` MCP server — the read tools `mcp__srd-doc__search` (query + optional `k`), `mcp__srd-doc__get_doc` (document id), and `mcp__srd-doc__list_docs` (no args). When a new or changed requirement asserts something about existing system behaviour, `search` the corpus to confirm it before accepting the edit. Degrade MCP → the `srd-doc` REST mirror (`curl 'http://:7777/search?q=TEXT&k=5'`, `.../docs/`) → scoped Grep/Read over a local corpus checkout, falling through only when a step genuinely is not there. Absent a corpus, edit offline as before. ### Reporting a doc gap When the corpus **cannot confirm** such a claim — missing, wrong, incomplete, or ambiguous docs — that is a *documentation* gap, not an SRD defect. Hand it to `srd:report-doc-gap`, which owns capture, the grill, and the confirmed filing; invoke it on discovery — it buffers the gap without interrupting the edit — and at session start, where it drains any gaps left unfiled. Editing the SRD text stays this skill's job; only corpus deficiencies cross to `report-doc-gap`. ## Session start (every mode) Before any edit: 1. **Read** the whole SRD top to bottom. 2. **Approval gate.** Read the `Status` metadata, pre-fill approved (`Accepted`) vs in-progress (anything else), then **show it and ask the user to confirm or override**. The answer governs id rules for the whole session — never trust `Status` silently. 3. **Glossary.** Run the glossary-resolution procedure in [../create/references/srd-procedures.md](../create/references/srd-procedures.md). ## Id rules The approval gate decides what may happen to requirement / scope / glossary ids: - **In-progress** — free to renumber a group after a split, merge, add, or remove, and to fix collisions or gaps (REQ-2/3/4). Update every cross-reference the change touches. - **Approved** — **existing ids are frozen.** Additions only, via sub-numbering (`GR-1a`, `GR-1b`); never renumber or rename an existing id. If a real fix cannot be done without touching an existing id, **try add-only first**; if that is impossible, present the conflict and the trade-off and **leave it flagged** unless the user explicitly approves the id change. Whenever any id must change, **state the change and get explicit approval** as part of the one-change confirmation. ## Edit discipline All interactive editing follows the same loop. Per change: 1. Propose **exactly one** change: its location/id, the problem (cite the rule id), the **before** and **after** text, and a one-line rationale. 2. Apply only on explicit approval. Never batch unrelated changes. Never edit without confirmation. 3. **Re-validate the affected entry + cross-refs** immediately against the rules in [../create/references/srd-standard.md](../create/references/srd-standard.md), focusing on the checks the edit can touch: scope coverage (SCO-2/3), id uniqueness/order (REQ-3/4), term use (GLO-3), and any requirement that references or is referenced by the edit. Report if the fix introduced a new problem. When the edit asserts a claim about existing system behaviour and a corpus is available, confirm it against the docs (see [Documentation corpus](#documentation-corpus-when-available)) and delegate any doc gap to `srd:report-doc-gap`. 4. At **session end**, re-check the whole document against every rule in the standard plus the consistency pass in [../create/references/authoring-guide.md](../create/references/authoring-guide.md), and report what remains. Write every edit to the LANG, MD, and REQ rules in [../create/references/srd-standard.md](../create/references/srd-standard.md) (US English and one term per concept per the authoring guide). When an edit restructures sections, follow the order in [../create/assets/srd-template.md](../create/assets/srd-template.md). ## Modes Detect the mode from the user's words; the default is interactive. - `edit path/to/srd.md` → **interactive** (default). - `edit path/to/srd.md .review.md` (or with pasted feedback) → **feedback**. - `edit path/to/srd.md polish` → **polish**. - `edit path/to/srd.md ` → **targeted**. ### interactive (default) 1. Run the session-start steps. 2. **Front-load** a grouped issue summary — read the whole SRD and present every issue found, grouped by document section (Metadata, Introduction, Glossary, Scope, Requirements), each citing its rule id. Edit nothing yet. 3. **Walk entry by entry** in document order — each requirement (`PFX-n`), each glossary term, each scope item — applying the edit-discipline loop to every fix the user approves. Move to the next entry only after the current one is resolved or skipped. 4. Close with the full consistency pass and the chat summary. ### feedback Apply findings from a review. **Never write the review file** — `review` owns it. After editing, tell the user to run `review check` to reclassify what landed. 1. Input is a `.review.md` path **or feedback pasted inline** (email, ticket, chat). Parse the findings from either. 2. Run the session-start steps. 3. Work findings in **severity order — blocker → major → minor** (use the review's tags and finding numbers; for untagged pasted feedback, judge severity from the rule). 4. For each finding, run the edit-discipline loop: propose the fix, apply on approval, re-validate. Reference findings by their number in the chat summary; leave the review file untouched regardless of outcome. 5. Close with the full consistency pass and the chat summary, then point the user to `review check`. ### polish Mechanical-only cleanup, still **confirm each** change (same loop). Scope is limited to: 80-column wrap (MD-2), British → US spelling, identifier format/order (REQ-2/3/4 — subject to the approval gate), keyword capitalization (LANG-4), valid Markdown (MD-1), stray example/note text (REQ-7), spacing and punctuation. Do not rewrite requirement meaning or restructure. Close with the chat summary. ### targeted Edit one entry the user points to — by **requirement id** (`GR-3a`), **quoted text**, or **free description** ("the login timeout rule"). 1. Run the session-start steps. 2. Locate the target. For quoted text or a description, **confirm the match** before editing. 3. Apply the edit-discipline loop to that entry. 4. **Always run a consistency check after** — the affected entry plus its cross-refs — and report whether the edit introduced any inconsistency. ## Deliverable Close every session with an in-chat summary — a manifest of approved edits, not a re-narration of diffs the user already saw: - What changed: entry/id, one line each. - What was flagged and left (frozen-id conflicts, metadata gaps, anything the user declined). - Outstanding human follow-ups (placeholders, back-links, Status). Report tersely: no preamble or narration; state each fact once; don't restate output the user can already see. ## Self-learning Read this skill's lessons and obey them: sibling `LESSONS.md`, else `$HOME/.agent-data/ctx42-skills/lessons/srd/edit.md` when this directory is read-only. On a correction or self-caught mistake, append a one-line rule to whichever is writable (creating it) and report where. ## Source & license This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [ctx42](https://github.com/ctx42) - **Source:** [ctx42/skills](https://github.com/ctx42/skills) - **License:** MIT Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** yes - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/skill-ctx42-skills-edit - Seller: https://agentstack.voostack.com/s/ctx42 - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.