Skill score

Operation: skill_score
Price: 8 credits / $0.08 display equivalent
Scope: scores:read

See REST result fields for Trust, Confidence, status, freshness, ledger, charge source and balance units.

Use before importing, installing or enabling a Skill. The result should resolve to the same Trust and Confidence fields shown on the canonical /s Page.

{
  "operation": "skill_score",
  "subject": "owner/repository",
  "channel": "api",
  "idempotency_key": "skill-owner-repository-01"
}

When to use it

Run skill_score before installing, importing or enabling a capability, especially when it can read files, call external services, execute commands or access secrets. Recheck when the package source or repository changes beyond your freshness window.

Code examples

curl --request POST 'https://www.clawdbase.ai/api/clawdbase/operations/run' \
  --header "Authorization: Bearer $CLAWDBASE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "operation": "skill_score",
    "subject": "owner/repository",
    "channel": "api",
    "idempotency_key": "install-884:skill_score:owner-repository"
  }'

const response = await fetch('https://www.clawdbase.ai/api/clawdbase/operations/run', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CLAWDBASE_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    operation: 'skill_score',
    subject: 'owner/repository',
    channel: 'api',
    idempotency_key: `install-884:skill_score:owner-repository`,
  }),
  signal: AbortSignal.timeout(50_000),
})

const body = await response.json()
if (!response.ok) throw new Error(body.error)

import os
import requests

response = requests.post(
    "https://www.clawdbase.ai/api/clawdbase/operations/run",
    headers={
        "Authorization": f"Bearer {os.environ['CLAWDBASE_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "operation": "skill_score",
        "subject": "owner/repository",
        "channel": "api",
        "idempotency_key": "install-884:skill_score:owner-repository",
    },
    timeout=50,
)

body = response.json()
if not response.ok:
    raise RuntimeError(body.get("error", "operation failed"))

A 502 means the upstream assessment failed and no credits settled. Preserve any prior confirmed Page evidence as stale rather than replacing it with a zero score.

Decision context

Verify that the resolved Skill matches the exact repository or package being installed. Read its Creator relationship separately and request agent_skill_lineage when forks, templates or upstream artifacts affect provenance.

Integration pattern

const evidence = await checkClawdbase({
  operation: 'skill_score',
  subject: 'owner/repository',
  idempotencyKey: installJob.id,
})

await recordInstallDecision({
  skillPageId: canonicalPageId,
  ledgerId: evidence.ledger_id,
  policyVersion: 'skill-install-v2',
})

Store the canonical Page and ledger references with your installation decision. Do not store the Access Key or treat the score as package-signature verification.

Failure behavior

The same shared status contract applies. A 502 means the upstream assessment failed and no credits settled. Preserve any prior confirmed Page evidence as stale rather than replacing it with a zero score.

When to use it

Code examples

Decision context

Integration pattern

Failure behavior

On this page