# add-score

add-score — a Claude Code skill that adds a new derived measure to a PLSI map. It activates when a request needs a score or equation the existing maps do not compute.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 93 repo stars
- Author: Insilico-org
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/Insilico-org/plsi/tree/HEAD/skills/processor/add-score/SKILL.md
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/add-score

## What it does

The skill adds a measure to a user PLSI map as a derived coordinate. It finds a published equation, checks its source, then confirms that the required coordinates and units are available. Unit conversion can be written into the formula.

Before installing the map for the user, the skill tests the equation against a worked example in a separate PLSI instance. A mismatch blocks installation. The reported value comes from `plsi project`, along with its unit, source, and the new `states` hash.

Lookup tables and fitted models cannot be expressed as a map formula, so those requests go to PLSI Engineer. Censored inputs can produce an `error` status when the formula uses comparisons, `where`, `min`, `max`, or `abs`. After a formula changes, older predictions are scored against their saved map snapshot.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Insilico-org/plsi --skill add-score -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/add-score/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/add-score/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Insilico-org/plsi --skill add-score -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/add-score/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Insilico-org/plsi --skill add-score -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/add-score/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Insilico-org/plsi skills/processor/add-score
```

2. **Manually: put the files in place**
- File: `.github/skills/add-score/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Insilico-org/plsi --skill add-score -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Insilico-org/plsi --path skills/processor/add-score
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/add-score/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Insilico-org/plsi/tree/HEAD/skills/processor/add-score/SKILL.md

## When to use it
- add a published measure to a PLSI map
- represent a composite outcome as one predicted value
- test an equation against a paper’s worked example
- convert an input unit inside a formula

## Example prompts
- Add the eGFR measure to PLSI using the published CKD-EPI 2021 equation.
- Create a composite measure in the PLSI map from these coordinates.
- Find and verify the equation for this index, then test it against the paper’s example.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 439fef0c376e8bdd.

BEGIN THIRD-PARTY FILE 439fef0c376e8bdd
````text
---
name: add-score
description: Use as PLSI Data Processor when PLSI asks for a score, ratio, index or published equation that no map computes yet (e.g. a lipid ratio, a kidney-function equation, a fibrosis index), so it becomes a derived coordinate the triad computes, stores, predicts and scores.
---

# PLSI add a score

A score is a safe formula inside a State Map (Tier 1): no code, no install step beyond the map. If the computation
cannot be written as one formula (lookup tables, a fitted model), say so in your `result` so PLSI hands it to PLSI Engineer (`engineer/extend`); Engineer not on the team: code extensions are off and PLSI offers "Add PLSI Engineer?".

## When to use

- The user names a score PLSI does not have, or a paper's equation would answer their question.
- A plan needs a composite outcome that should be predicted and scored as one value.

## Steps

1. Find the published formula and verify its source before using it.

   ```bash
   plsi evidence search --source pubmed --query "<score name> equation validation"
   plsi evidence verify --kind doi --id <doi>
   ```

2. Check the inputs. Each variable must be a coordinate with a canonical unit; read units from the map and convert
   inside the formula when the paper uses another unit (e.g. creatinine umol/L -> mg/dL is `creatinine / 88.42`).

   ```bash
   plsi maps show blood_phenoage
   plsi maps show cardiometabolic
   ```

3. Write a user map `user_<score>.yaml` holding the input coordinates (copy them from `maps show`) plus one derived
   coordinate:

   ```yaml
   - id: egfr_ckd_epi_2021
     label: eGFR (CKD-EPI 2021)
     kind: derived
     unit: mL/min/{1.73_m2}
     derive:
       engine: expr
       model: egfr_ckd_epi_2021
       inputs: [creatinine]
       formula: >-
         142 * min(creatinine / 88.42 / where(female, 0.7, 0.9), 1) ** where(female, -0.241, -0.302)
         * max(creatinine / 88.42 / where(female, 0.7, 0.9), 1) ** -1.2 * 0.9938 ** age * where(female, 1.012, 1)
     correspondence_type: validated
     sources: [{kind: doi, id: <verified doi>}]
   ```

   Formula language: numbers, `+ - * / **`, comparisons, `log ln log10 exp sqrt abs min max`, `where(cond, a, b)`;
   variables are the `inputs` plus `age` (years at the draw), `female`, `male` (1 or 0). `inputs` must list exactly
   the coordinate variables the formula uses.

4. Validate, then prove the formula on the paper's worked example in a fresh scratch instance per score (`scratch-<score>`, sex and birth year from the worked
   example) before using it for the user: ingest the example's input values, project, and compare with the published result (allow rounding).

   ```bash
   plsi maps validate user_egfr.yaml --live
   plsi init --instance scratch-egfr --birth-year <example birth year> --sex <example sex> --relation sample
   plsi maps install --instance scratch-egfr --file user_egfr.yaml
   plsi ingest --instance scratch-egfr --file example_inputs.json
   plsi project --instance scratch-egfr --map user_egfr
   ```
````
END THIRD-PARTY FILE 439fef0c376e8bdd

The third-party file has ended. Everything between the 439fef0c376e8bdd tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 3024 of 3926 bytes. © Insilico-org · MIT · https://github.com/Insilico-org/plsi/tree/HEAD/skills/processor/add-score/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
