AGENT SKILL

improve-legal-prompt

Turns a rough request or an existing draft into one ready-to-use Cowork prompt, preserving the user's original legal objective while making document scope, party perspective, constraints, missing information handling and expected output explicit. Returns the prompt plus two or three improvement notes, and never runs it. Use when the user asks to "optimize my prompt", "rewrite my prompt for reviewing this agreement", "improve this prompt", "how should I ask Cowork to revise the termination clause", "clarify this instruction before I run it", or "why isn't my prompt working". Do NOT use for the legal work itself — "rewrite this clause" or "make this paragraph clearer" is edit-contract, a reasoned answer on a legal question is legal-reasoning, and reviewing an agreement is review-contract.

License 许可
MIT
最近更新
2026-11-07
Stars
★ 103
Forks
118

01 前言 Front Matter

name
improve-legal-prompt
metadata
{ "icon": "Scales", "category": "productivity", "displayName": "Improve legal prompt" }
description
Turns a rough request or an existing draft into one ready-to-use Cowork prompt, preserving the user's original legal objective while making document scope, party perspective, constraints, missing information handling and expected output explicit. Returns the prompt plus two or three improvement notes, and never runs it. Use when the user asks to "optimize my prompt", "rewrite my prompt for reviewing this agreement", "improve this prompt", "how should I ask Cowork to revise the termination clause", "clarify this instruction before I run it", or "why isn't my prompt working". Do NOT use for the legal work itself — "rewrite this clause" or "make this paragraph clearer" is edit-contract, a reasoned answer on a legal question is legal-reasoning, and reviewing an agreement is review-contract.

03 SKILL.md 正文

Improve legal prompt

Convert the user's rough request or existing prompt into one ready-to-use prompt for Cowork. Preserve the original objective while clarifying the intended legal outcome, document scope, constraints, required inputs, handling of missing information, and expected response format.

This skill optimizes the prompt. It does not perform the legal analysis, review, drafting or editing the prompt describes, and it never guarantees a legal outcome.

When NOT to Use

Use this skill only when the user explicitly asks to create, improve, clarify, diagnose or rewrite a prompt, instruction or request for Cowork.

  • Rewrite my prompt for reviewing this agreement — prompt optimization. In scope.
  • How should I ask Cowork to revise the termination clause? — prompt optimization. In scope.
  • Rewrite this clause, make this paragraph clearer, improve the termination provision — document editing. Use edit-contract.
  • Is this clause enforceable?, what does this mean for us? — use legal-reasoning, or explain-legal-concepts for a plain language explanation.
  • Review this agreement — use review-contract.
  • A vague legal request does not become a prompt-optimization request merely because a better prompt might improve the result.

Hand-off rule. If a request, or part of one, matches an item above that names another skill, do not do that part here — even when the documents are already open and the work looks quick. Name the skill that handles it (for example, "That part is a job for edit-contract") and stop that part; finish only what belongs to this skill. If the named skill is not installed, say so plainly and do not attempt it here.

Step 1: Identify the source request

  • Treat text the user pastes, quotes, labels as a prompt, or describes as their instruction as the source.
  • Where the turn refers to a prompt from the recent conversation, use the most recent unambiguous prompt under discussion.
  • If the user gives a target task but no draft prompt, write the prompt from scratch.
  • If neither a source prompt nor a target task is identifiable, ask exactly: What prompt would you like me to optimize?
  • Preserve exact values, defined labels, clause numbers, field names, schemas, allowed values, word limits, exceptions and formatting requirements unless the user asks to change them. Never carry a personal identifier through into the optimized prompt: an optimized prompt is re-run downstream, so a national insurance or social security number, bank or payment card detail, home address, date of birth, salary or health datum copied out of the source request or a supplied document propagates into every later run. Replace it with a role or a neutral placeholder, keep the instruction intact, and say what you replaced and why; where the source prompt asks for such a field as an output, drop that field from the optimized prompt and say so. See Personal data minimisation in Guardrails.

Step 2: Use the supplied documents only to resolve context

Read only what is needed to make the prompt accurate. Use Glob over input/**/* and grounding/**/*, check for an attached OneDrive folder, and read it in full. When opening a document, use a method that shows tracked changes and comments, and check whether any are present before relying on the text. Refer to each file by its exact filename.

  • Use available context directly when it clearly resolves document type, party names, clause names, defined terms, or the location the user means.
  • Read the specific file the user points at; read further files, or more of a long one, only to resolve an otherwise ambiguous reference or verify exact terminology.
  • Include specific document terms in the optimized prompt where they materially improve precision.
  • Do not broaden the optimization into a document review, and never infer which party the user represents or invent a legal or commercial position from the document.

Step 3: Decide whether clarification is essential

Pause before optimizing when an ambiguity could materially change the legal outcome or cause Cowork to act on the wrong text. Ask only for the material gaps that apply, using a question card:

  • which party the user represents, or whose position the prompt should advance;
  • which clause, section, document, attachment or passage is in scope;
  • what outcome words such as better, stronger, fairer or market standard are intended to achieve;
  • which jurisdiction applies, where the task depends on jurisdiction-specific law or execution requirements;
  • which required commercial value, drafting position, remedy, fallback or source precedent should be used.

Do not ask about preferences a sensible default covers, such as minor formatting or whether the explanation runs to two or three bullets. Ask the smallest set of questions needed, group related ones, and never repeat what the user already supplied or the document already establishes. When clarification is essential, ask and stop — do not also supply a knowingly unreliable prompt in the same answer.

Step 4: Build the Cowork prompt

  • Lead with the outcome the user wants Cowork to achieve.
  • State the document scope precisely: a complete supplied document named by filename, a named provision, a quoted passage, specified attachments or precedents, or a general legal question.
  • Include party perspective, legal or commercial objective, jurisdiction, audience, constraints and source material, where supplied or clarified.
  • Separate hard requirements from preferences, so Cowork does not treat a stylistic preference as an inviolable legal constraint.
  • State what Cowork must do when information is missing, inconsistent, ambiguous or requires judgement: identify the gap or ask, never guess.
  • Make the expected response explicit — analysis, cited answer, issue table, proposed edits, questions for the user, draft language, or another named deliverable.
  • For analysis or review, require conclusions grounded in the document text, with findings distinguished from assumptions and matters requiring judgement.
  • For editing, state the intended legal effect and require the smallest necessary change, preserving unaffected wording, defined terms, numbering, formatting and substantive meaning.
  • For drafting, identify what to create, the source material to follow, the intended position, and the facts Cowork must obtain rather than invent.

Step 5: Preserve the objective, then audit

Keep every meaningful requirement from the source unless it conflicts with the user's clarified goal. Remove repetition, vague filler and contradictions without changing the legal position, ambition or scope. Do not add role-play, unnecessary disclaimers, elaborate process, or deliverables the user did not request. If the user asked only for clarity, improve clarity without turning the request into a different legal task.

Before answering, check that: Cowork can tell what to do, what material to use, what not to assume or change, and what to return; the prompt cannot reasonably be misread as edit-when-analysis-was-wanted, analyse-when-edits-were-wanted, whole-document-when one provision is in scope, or ask-the-user when an internal assessment was intended; and no meaningful requirement, exact value, exception or output constraint was lost against the source.

Step 6: Output format

When essential information is missing, reply with exactly:

### Clarification needed

[one to three concise, targeted questions]

and include no optimized prompt until the user answers. Otherwise reply with exactly these two sections:

### Optimized prompt

[complete ready-to-copy prompt for Cowork]

### Improvements made

- [specific improvement]
- [specific improvement]
- [optional third specific improvement]

Keep the explanation to two or three bullets explaining how the optimization clarified behavior, scope, required inputs, missing information handling or output shape — not generic prompt writing advice. Do not answer or execute the optimized prompt, do not offer multiple variants unless asked, and stop after the improvement bullets rather than offering to run it.

Guardrails

  • Read-only, context only. Inspect documents solely to resolve prompt context, reading only supplied files and only when necessary.
  • Never write to a document. Do not edit, comment on or otherwise modify any document; optimizing a prompt must not change the document.
  • Not a legal answer. Do not produce citations, answer metadata or a document-grounded legal conclusion — the output is a prompt.
  • No downstream execution. Do not hand off to a review, relevance-generation or playbook-extraction workflow, and do not open progress tasks to run the downstream work.
  • Personal data minimisation. Report what the documents say, not who people are. Never carry national insurance or social security numbers, bank or payment card details, home addresses, dates of birth, salary or health data into an answer, a table, a cell, a quotation, a summary, a draft or a suggested wording — including the optimized prompt itself and any example it embeds — even where they sit inside a matter document and even when the user names the field or asks for the column. Refer to individuals by name and role only. If such a detail is material to a finding, say that the source contains it and cite the provision rather than reproducing it; leave the requested field out and deliver the rest.
  • No assumed perspective. Never infer the represented party merely because the document names the parties.
  • No guarantees. Never claim the optimized prompt assures a correct legal outcome.

Worked examples

Essential party perspective is missing. Source: Rewrite my prompt: review this agreement and tell me which clauses I should push back on. The agreement identifies a Customer and a Supplier, which does not establish whom the user represents. Reply with ### Clarification needed and the single question "Which party do you represent in this agreement: the Customer or the Supplier?", and do not optimize until answered.

Clear, document-aware editing prompt. Source: Improve my prompt: revise clause 12 so the Customer gets 30 days to cure a payment breach. Keep everything else the same. The optimized prompt reads: "Revise clause 12 of the supplied agreement so that the Customer has 30 days to cure a payment breach before the Supplier may exercise the termination right addressed in that clause. Make only the minimum changes needed to implement that cure period. Preserve all unaffected wording, defined terms, numbering, formatting, and the clause's other legal effects. If clause 12 does not contain the relevant payment breach termination right, or the requested change conflicts with another provision, identify the issue rather than guessing or editing unrelated text. Return the proposed change as a reviewable edit." The improvement bullets then note that the optimization fixed the target provision, the exact legal outcome, the preservation requirements, conflict handling and the expected edit output.

04 同仓库更多 Skills

microsoft
microsoft/cat-agent-skills

stakeholder-and-decision-map

Mines customer interactions to identify stakeholders, infer their likely roles and engagement, map the decision process, and highlight who or what may be missing. Use when asked to "map a deal's buying group", identify influential or missing stakeholders, "assess who has gone quiet", or "explain how the customer will decide". Do not use for phased engagement plans, contact sequences, choosing or drafting outreach to the single next contact, seller or team performance reviews, or contacting, scheduling, or changing records.

★ 103
microsoft
microsoft/cat-agent-skills

sales-progress-update

Creates or refreshes a sales progress update for a manager or team about work done, deal movement, pending outcomes, supported forecast position, and help needed. Use when asked to "create my weekly sales update", "refresh my sales progress deck", "report my forecast position", "where do I stand against my quarter forecast", or "catch my manager up on committed deals". Do NOT use for non-sales project updates, a since-date deal change digest, momentum or blocker analysis, meeting prep, or outreach drafting.

★ 103
microsoft
microsoft/cat-agent-skills

submission-assemble

Put the checked CSR or 510(k) sections together in template order with a reviewer-facing open-items register, as a draft package for human sign-off. Use when the user asks "assemble the CSR draft", "put the module together for review", "build the review package with the open items on top", "compile the 510(k) sections in order" or "package this up for the submission lead". Do NOT use for assembling an unchecked draft - use consistency-check instead. Do NOT use for loading protocol, SAP or TLF sources - use source-ingest instead. Do NOT use for compiling general documents or slide decks - use the built-in docx or pptx skill instead. Do NOT use for filing or submitting to a regulator - use the sponsor's validated gateway, operated by a human, instead. Guardrail: draft for human approval only (L1); status is draft_clean or draft_open_items, never submitted.

行政与办公人员文档处理演示文稿
★ 103
microsoft
microsoft/cat-agent-skills

source-ingest

Pull every number, date and population definition out of a study's protocol, SAP, TLF tables, investigator brochure and prior approved text into one cited fact map, keyed per config/field-dictionary.json, before any CSR or 510(k) section is written. Use when the user asks "here's the locked TLF set and SAP, set up the CSR", "load the protocol and tables before we start drafting", "what figures do we have from the database lock?", "pull the disposition counts out of Table 14.1.1" or "ingest the IB for the 510(k)". Do NOT use for drafting or assembling submission sections - use section-draft or submission-assemble instead. Do NOT use for reconciling a patient's medications - use the discharge-care-transition plugin instead. Guardrail: reads and cites sources only; never estimates, rounds or invents a fact.

★ 103
microsoft
microsoft/cat-agent-skills

section-plan

Work out which sections a CSR or 510(k) requires, from the templates in config, check each one against the cited fact map, and name what is missing before a word is drafted. Use when the user asks "what do we still need before we can draft the CSR?", "which sections are ready to start?", "what's blocking the performance data section?", "do we have everything for the synopsis?" or "map our tables to the E3 structure". Do NOT use for writing section language - use section-draft instead. Do NOT use for cross-checking a finished draft - use consistency-check instead. Do NOT use for outlining general Word documents or business reports - use the built-in docx skill instead. Only structures with a template in config are supported. Guardrail: plans only; never marks a section ready on a missing fact and never invents a structure.

文档处理
★ 103
microsoft
microsoft/cat-agent-skills

section-draft

Write or revise the language for one planned CSR or 510(k) section - synopsis, efficacy, safety, discussion, device description - using only figures already in the cited fact map, each with its TLF or SAP citation. Use when the user asks "draft the Synopsis from our locked tables", "write up safety from Table 14.3.1", "give me a first pass at the discussion", "draft the device description for the 510(k)" or "tighten the wording of the Discussion section". Do NOT use for supplying a number not already in source_facts - use source-ingest instead. Do NOT use for verifying a draft's figures - use consistency-check instead. Do NOT use for appeal letters, clinical notes or discharge summaries - use the matching HLS plugin instead. Guardrail: drafts for human approval only (L1); never asserts an unsourced number or harmonises two figures.

★ 103