fuck-cancer README

The project's README from github.com/petergyang/fuck-cancer. As one markdown file: README.md.

Fuck Cancer

Create and update a practical brief to help patients and caregivers advocate for themselves.

https://github.com/user-attachments/assets/551549ee-4afa-4c4e-ae07-6266ec4a129d

Problem

Since I published my mom's story, I’ve heard from many people supporting a loved one through cancer.

The last thing a patient or caregiver needs is a pile of confusing medical terms, hype, and scattered information. Instead, they need clear answers to three questions: What should we do next? What do we know? How can we advocate for ourselves?

Here's what patients and caregivers have told me:

"You have to be a huge patient advocate. Push for answers. Push for biopsies. Push for proper testing. Ask questions."

"I need help navigating difficult conversations and advocating for myself."

"The volume of doctors, documents, and insurance paperwork can quickly become overwhelming."

What this skill does

Sample family medical brief with patient information, what to do next, what we know, medical terms, and a compact care log

This skill creates a concise, fact-based brief with 5 sections:

  1. Patient information. Essential identifiers, care team contacts, and more for easy reference during phone calls.
  2. What to do next. Up to 3 specific actions naming the next steps.
  3. What we know. The shortest useful summary of what's confirmed vs. what's still ambiguous. Can also include research on clinical trials.
  4. Medical terms. Plain-English explanations of medical terms and acronyms.
  5. Care log. A compact history of recent updates.

It creates this brief based on documents and context that you share with it and trusted medical sources like NCI's PDQ summaries and the ClinicalTrials.gov API.

On first use, the skill will ask you whether to create the brief in a local Markdown file or a shareable Google Doc. You can run the skill with more context to update the brief over time.

How to install the skill

The easiest way to install the skill is to paste this into ChatGPT, Claude Code, or your favorite agent:

Install the /fuck-cancer skill globally from https://github.com/petergyang/fuck-cancer

You can also install it with npx:

npx skills add petergyang/fuck-cancer --skill fuck-cancer --global --yes

How to use the skill

Start with a brain dump:

/fuck-cancer My dad was just diagnosed. Here’s what I know.

Paste or upload a report:

/fuck-cancer Explain this report and help me prepare for doctor meeting.

Research trials or second opinions:

/fuck-cancer Find relevant trials near Toronto for this diagnosis.

Share new information as it arrives:

/fuck-cancer Update our brief with this new biomarker report.

Trusted medical sources

The skill grounds its research in trusted medical sources:

  1. Evidence and treatment context: NCI's PDQ summaries or the official cancer agency for the patient's country.
  2. Drug approvals and labels: The patient's national regulator, such as the FDA, Health Canada, EMA, MHRA, or TGA.
  3. Testing and clinical guidance: Current official publications from groups such as ASCO, ESMO, CAP, or NICE when they directly apply.
  4. Clinical trials: The official ClinicalTrials.gov API, including the status of the individual site.
  5. Medical definitions: The NCI Dictionary of Cancer Terms or an equivalent official national source.
  6. Emerging questions: Peer-reviewed primary research indexed in PubMed, with early or indirect evidence labeled as such.
  7. Specialists and services: Official academic cancer-center pages for their own clinicians, programs, and trials.

Disclaimer

The skill supports decisions with current evidence. It does not diagnose cancer, choose treatment, determine trial eligibility, or replace the patient's medical team.

What's inside

  1. SKILL.md contains the complete care-navigation and research workflow.
  2. search_trials.py searches ClinicalTrials.gov API v2, filters sites by distance from home with --near LAT,LON, labels each site's recruitment status, and ranks likely matches first.
  3. eval.md checks the destination, brief structure, action specificity, medical boundaries, and concise care-log format.
  4. test_search_trials.py covers location normalization, distance filtering, site-status handling, pagination, criteria previews, and relevance ordering.
  5. openai.yaml contains the Codex skill metadata.

Local Markdown mode requires no account, database, or API key. Google Doc mode uses the user's connected Google Drive integration; if it is not connected, the skill asks the user to enable it before writing. The trial-search helper requires no API key, uses only Python's standard library, and requires Python 3.8 or newer.

License

MIT

fuck-cancer (petergyang/fuck-cancer)

Searching Database…

148 ·GitHub
Fuck-cancer
What is this?It is an agent skill that creates and keeps updated a practical brief for cancer patients and caregivers, covering patient info, next steps, what is known, medical term explanations, and a care log.
Is this a standalone app or a skill I add to an AI assistant?It is a skill package (SKILL.md plus helper scripts) that you install into ChatGPT, Claude Code, or another agent, not a standalone application.
How do I install and start using it?Paste the install snippet into ChatGPT, Claude Code, or your favorite agent (or run it with npx), then start by giving it a brain dump, uploading a medical report, or asking it to research trials or second opinions.
Do I need an API key or account to use it?Local Markdown mode needs no account, database, or API key; the trial-search helper only needs Python 3.8+ and its standard library, with no API key required.
Can this skill make medical decisions for me?No - it only supports decisions with current evidence and explicitly does not diagnose cancer, choose treatment, determine trial eligibility, or replace the patient's medical team.
Where does my brief and data go?You choose: a local Markdown file that stays on your machine, or a shareable Google Doc that uses your connected Google Drive integration.
What trusted medical sources does the skill pull from?It grounds research in NCI PDQ summaries, national drug regulators like the FDA or EMA, guideline bodies such as ASCO, ESMO or NICE, the ClinicalTrials.gov API, the NCI Dictionary of Cancer Terms, and peer-reviewed PubMed research.
Why did the author build this?After sharing his mom's cancer story, the author heard from many patients and caregivers overwhelmed by medical jargon and paperwork who needed clear, actionable guidance to advocate for themselves.
How does the clinical trial search work?The included 'searchtrials.py' script queries the ClinicalTrials.gov API v2, can filter sites by distance using '--near LAT,LON', labels each site's recruitment status, and ranks likely matches first.
What are similar projects?no-ai-slop, easyread, newsjack, obsidian-second-brain, open-codesign, jinba-consulting-pptx-skill, awesome-claude-skills, unsloth
Which topics is it in?healthcare, health, chatgpt, skill, anthropic, local-first, agent-skills, openai, codex, productivity, research, privacy
Creator
petergyang
Size
2 MB
Stars
148
Updated
CommitAug 26
Age
1mo
Commits · 90 Days