Skip to content

gaia-research/gaia-skill-tree / .agents/skills/trust-appraise

trust-appraise

Verified

Dry-run Trust Magnitude for proposed named skills or suites before curation. Use when deciding whether a proposed suite deserves A/S treatment, when checking Fusion Score structural inputs, when comparing repo stars vs suite component counts, or when asked to appraise a candidate before adding it to the registry.

FileKindSize
SKILL.mdskill md5.0 KB
---
name: trust-appraise
description: >
  Dry-run Trust Magnitude for proposed named skills or suites before curation. Use when deciding whether a proposed suite deserves A/S treatment, when checking Fusion Score structural inputs, when comparing repo stars vs suite component counts, or when asked to appraise a candidate before adding it to the registry.
version: "1.1.0"
genericSkillRef: registry-inspection
---

# /trust-appraise

Runs a **non-mutating** Trust Magnitude dry run. Formulas, dedup, inheritance, grade
floors and star gates are **not** restated here. The canonical source is
[`docs/agents/curation-authority-map.md`](../../../docs/agents/curation-authority-map.md),
which is checked against `src/gaia_cli/trustMagnitude.py` by
`tests/test_curation_authority_map.py`.

Two modes:

1. **Registry mode** (`--skill`) appraises an already-curated skill. A `contributor/skill` id
   reads `registry/named/<contributor>/<skill>.md` and resolves its `genericSkillRef`
   against `registry/nodes/`. A bare id reads the generic node. Use it during L4 human
   review to see the real TM and per-row artifact scores before signing off.
2. **Proposal mode** (`--repo`) appraises a proposed suite from live GitHub signals before
   curation. It is the pre-curation companion to `/trust-appraise-all`.

## Usage

```bash
# Appraise one or more curated skills (use during L4 human review)
PYTHONPATH=src python3 scripts/trust_appraise.py \
  --skill rico-favor/implement-with-discernment \
  --skill caioribeiroclw-pixel/evidence-attestation

# Appraise a proposed suite (pre-curation)
PYTHONPATH=src python3 scripts/trust_appraise.py \
  --repo gsd-build/get-shit-done \
  --components 5 \
  --evidence-path docs/INVENTORY.md

# Default suite appraisal set
PYTHONPATH=src python3 scripts/trust_appraise.py

# Machine-readable output
PYTHONPATH=src python3 scripts/trust_appraise.py --skill foo/bar --json
```

**Frozen skills:** a frozen skill's standing is its locked TM/grade (`gaia_cli.frozen`), never
the recomputation. The text output prints `FROZEN - locked TM ... / ...; current recomputation
... / ...` and the JSON carries `frozen`, `recomputedTm`, `recomputedGrade`. Report the lock as
the standing and the recomputation only as information; the rows below it are the recomputation.

## Scope labels: always report them

Every result carries `scope`, `genericResolution` and `totalStatus` (authority map §2):

| Mode | `scope` | `genericResolution` | `totalStatus` |
|---|---|---|---|
| `--repo` proposal | `named-own/proposal` | `not evaluated` | `partial` |
| `--skill` named, generic ref resolves | `effective named` | `resolved` | `final` |
| `--skill` named, generic ref missing from the registry | `named-own` | `not evaluated` | `partial` |
| `--skill` named with no `genericSkillRef` | `effective named` | `not applicable` | `final` |
| `--skill` generic node | `generic` | `not applicable` | `final` |

A `partial` total is **never** the effective named TM. Say "generic: not evaluated", not
"inheritance disallowed". Generic-layer evidence that a skill later inherits still counts,
even when it does not prove implementation usage.

## Proposal-mode metrics and their status

The proposal builds a temporary skill from its own rows only:
- `github-stars-own` at the evidence blob URL
- `repo-own` at the repository root
- a structural `fusion-recipe` row, which scores 0 TM and feeds only the informational Fusion Score

`skillCountInRepo` is recorded and never divides a score. Each collected metric is reported
in `metricClaims` with a `verified` / `reported` / `inferred` / `unknown` status and its
repro command (authority map §5):

- `contributorContributionSum` is the sum of GitHub per-contributor `contributions`. It is
  **not** a count of unique commits. The engine's `repo-own` input field is named `commits`,
  so the proposal fills that input from the sum and labels it `inferred`. Never report it
  as "N commits".
- Repository metrics describe the whole repository. Skill-file installability (a verified
  `links.github` `blob/` URL) is a separate check.

## Important caveat

A high dry-run score is **not** promotion approval. Use this skill to surface evidence
quality and TM bias before L4 human review, never to bypass review. `arxiv` rows with 0
citations score 0 TM whatever their `trustNumber`. `social-signal` rows admit both eligible first-party and third-party demonstrations of the target skill (`sameAsAuthor = 1.0`, `publishCooldownDays = 0` — no 30-day hold, `views >= 1000` floor, `(type, url)` dedup, 3-row plateau, 80 TM cap; unrelated uploads do not qualify), need verifiable view counts (fabricated numbers inflate scores directly), and must record provenance (`creatorRelation`, `relevanceNote`). `proxy-containment` strictly requires a qualifying external, non-first-party repository (`externalStars >= 10000`), and synthetic `self-attestation` rows are never added to bypass the 49.9 TM suite-component shared-repository cap (#2473). 4★ strictly requires grade A (TM ≥ 100), and grade S (5★) needs an independent witness. Both rules are in authority map §3.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall