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…

这是什么?这是一个 agent 技能,为癌症患者和照护者创建并持续更新一份实用简报,内容涵盖患者信息、后续步骤、已知情况、医学术语解释和照护日志。
这是独立应用,还是加到 AI 助手上的技能?它是一个技能包(SKILL.md 加辅助脚本),装到 ChatGPT、Claude Code 或其他代理里使用,不是独立应用程序。
怎么安装并开始使用?把安装代码段粘贴到 ChatGPT、Claude Code 或你喜欢的代理里(或用 npx 运行),然后把脑子里的想法一股脑倒给它、上传一份医疗报告,或者让它调研临床试验或第二诊疗意见,以此开始。
用它需要 API 密钥或账号吗?本地 Markdown 模式不需要账号、数据库或 API 密钥;临床试验搜索助手只需要 Python 3.8+ 及其标准库,同样无需 API 密钥。
这个技能能替我做医疗决定吗?不能——它只是用当前证据为决策提供支持,并明确表示不会诊断癌症、不会选择治疗方案、不会判定试验入组资格,也不会取代患者的医疗团队。
我的简报和数据会去向哪里?由你选择:要么是留在你电脑上的本地 Markdown 文件,要么是通过你已连接的 Google Drive 集成创建的可共享 Google 文档。
它会从哪些可信医学来源取材?它的研究依据来自 NCI PDQ 摘要、FDA 或 EMA 等国家药品监管机构、ASCO、ESMO 或 NICE 等指南机构、ClinicalTrials.gov API、NCI 癌症术语词典,以及 PubMed 上的同行评审研究。
作者为什么做这个?在分享了他母亲的癌症经历后,作者收到许多患者和照护者的反馈:他们被医学术语和文书工作压得喘不过气,需要清晰、可落地的指导来为自己争取权益。
临床试验搜索是怎么工作的?附带的 searchtrials.py 脚本查询 ClinicalTrials.gov API v2,可以用 --near LAT,LON 按距离筛选试验地点,标注每个地点的招募状态,并把最可能匹配的结果排在前面。
Creator
petergyang
Size
2 MB
Stars
148
Updated
CommitAug 26
Age
1mo
Commits · 90 Days