# Request Amendment

> Draft HIPAA-aligned health-record amendment requests, separate patient claims from source-record evidence, track response timelines, and optionally prepare draft FHIR Task JSON. USE FOR: requests to correct, clarify, append, or dispute clinical note content, medications/allergies, diagnoses, encounter metadata, or other chart entries. DO NOT USE FOR: legal advice, diagnosis, threatening language,…

- **Type:** Skill
- **Install:** `agentstack add skill-realactivity-tula-request-amendment`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [realactivity](https://agentstack.voostack.com/s/realactivity)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [realactivity](https://github.com/realactivity)
- **Source:** https://github.com/realactivity/tula/tree/main/skills/request-amendment

## Install

```sh
agentstack add skill-realactivity-tula-request-amendment
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# request-amendment

## When to Use

✅ Use when:

- The patient says a record contains inaccurate or incomplete information
- The patient wants neutral language to request a correction or addendum
- The patient needs help tracking amendment response timelines
- The patient asks how to proceed after a denial
- FHIR Task draft output is requested and explicitly enabled

## When NOT to Use

❌ Don't use when:

- The user asks for legal advice, diagnosis, or treatment decisions
- The task is general health education with no record-integrity request
- The user asks for threats, accusations, or coercive language
- The workflow would send PHI to web tools or unapproved external services
- The user asks for automatic FHIR submission without explicit enablement and approval

## Workflow

1. **Intake.** Capture target encounter/date, target excerpt or field, patient concern, and requested correction outcome.
   - If source excerpt is missing, ask for it before drafting.

2. **Separate evidence.** Keep separate `patient_says`, `record_shows`, `supporting_evidence`, and `proposed_amendment`.
   - Never collapse them into one asserted fact.

3. **Classify the issue.** Use one category: factual error, outdated info, omitted context, attribution error, medication/allergy issue, encounter metadata issue, diagnosis/problem-list issue, or unclear-needs-review.

4. **Run safety/risk screen.** Use careful neutral language for sensitive domains (minors, behavioral health, SUD, abuse/neglect, controlled substances, identity mismatch, emergency-care implications).

5. **Draft amendment package.** Produce:
   - issue type
   - cited source excerpt
   - patient-stated correction request (labeled)
   - proposed provider-facing amendment language
   - confidence and rationale
   - patient letter draft
   - HIPAA timeline checklist (60 days + one 30-day extension rule)

6. **Apply HIPAA timeline rules.**
   - Use [`references/hipaa-164-526.md`](references/hipaa-164-526.md) for 60-day and one-time 30-day extension behavior.
   - Do not promise provider acceptance; only timeline response obligations.

7. **Handle FHIR path using feature flags.**
   - If `request_amendment.fhir_task_draft` is disabled: do not output Task JSON.
   - If enabled: generate draft Task JSON and validate locally.
   - Follow defaults and guardrails in [`references/fhir-task-amendment.md`](references/fhir-task-amendment.md).
   - Never post resources unless `request_amendment.fhir_task_post` is enabled and the user explicitly asks to post.

8. **Close with unresolved questions.** List missing dates, unknown routing office, missing source excerpts, and assumptions.

## Scripts

Use:

- `node {baseDir}/scripts/calc_deadline.mjs `
- `node {baseDir}/scripts/validate_fhir_task.mjs `
- `node {baseDir}/scripts/redact_phi_for_eval.mjs  `

See [`references/scripts.md`](references/scripts.md) for script arguments, outputs, and failure handling.

## Examples

See [`references/examples.md`](references/examples.md) for:

- straightforward factual correction
- denied amendment follow-up language
- FHIR-draft-enabled output (no POST)

## Privacy

This workflow handles PHI.

- Keep PHI inside `~/.openclaw/workspace/`.
- Never send PHI to web search, external APIs, CI logs, or telemetry.
- Evals must use synthetic or reviewed de-identified fixtures only.
- If output might leave workspace, redact before export.

## Troubleshooting

- Missing receipt date: return "deadline starts on provider receipt" and ask the user to record receipt date.
- Draft sounds accusatory: regenerate with neutral factual wording and remove intent attribution.
- FHIR validation fails: keep letter/timeline output and include validation errors in unresolved questions.
- User asks whether provider "must amend": clarify provider must respond on timeline, but may deny if record is accurate and complete.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [realactivity](https://github.com/realactivity)
- **Source:** [realactivity/tula](https://github.com/realactivity/tula)
- **License:** Apache-2.0

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:** no
- **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-realactivity-tula-request-amendment
- Seller: https://agentstack.voostack.com/s/realactivity
- 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%.
