Priority Score Calculator

Overview

You send one item's criterion values and the weights that matter to you; we return the score together with the contribution of every criterion, so the number can be checked rather than trusted. Scoring is absolute: each value is mapped onto its own fixed rubric, so the same item scores the same today, tomorrow and next quarter, whatever else is waiting to be done. That is the whole difference from business.decision_matrix, which ranks options against each other and therefore moves when the set changes. A criterion can be inverted so that less is better, weighted at zero to document that it was deliberately ignored, or declared missing-tolerant so an incomplete item still scores. Everything runs on decimal arithmetic at 34 digits and rounds HALF_UP to the decimal places you ask for, and the contributions always add up to exactly the score.

Prioritisation arguments are rarely about the weights and almost always about the arithmetic: two spreadsheets disagree, nobody can say which cell is wrong, and the answer changes when a row is added. A scoring service that publishes the contribution of every criterion and guarantees they add up to the total moves the discussion back to the weights, where it belongs.

When to use it

Scope

Non-goals

• Does not rank several items, and does not normalise against a population — that is business.decision_matrix, which shares this skill's weighted-sum engine but answers a comparative question
• Does not invent weights, rubrics or defaults you did not send
• Does not decide what to work on: a score is an input to that decision
• Does not store the score or the item

Properties

Capabilities

Cost & billing

Flat rate per invocation

File handling

How we handle your data

Input schema

Output schema

API contract

curl -sS -X POST "$BASE/v1/execute" -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' -d '{"skillKey":"business.priority_score","input":{"item":{"id":"TCK-4711","values":{"impact":8,"effort":3}},"weights":[{"criterion":"impact","weight":0.7,"scale":{"min":0,"max":10}},{"criterion":"effort","weight":0.3,"direction":"LOWER_IS_BETTER","scale":{"min":0,"max":10}}]}}'

import { Squillify } from "@squillify/sdk";

const sq = new Squillify({ apiKey: process.env.SQUILLIFY_API_KEY });

const { output } = await sq.execute("business.priority_score", {"item":{"values":{"impact":8,"reach":1000,"effort":3},"id":"TCK-4711"},"weights":[{"criterion":"impact","weight":0.5,"scale":{"min":0,"max":10}},{"criterion":"effort","weight":0.3,"direction":"LOWER_IS_BETTER","scale":{"min":0,"max":10}},{"criterion":"reach","weight":0.2,"scale":{"min":0,"max":2000}}]});

Errors

Other limits

Limitations

• Does not rank several items, and does not normalise against a population — that is business.decision_matrix, which shares this skill's weighted-sum engine but answers a comparative question
• Does not invent weights, rubrics or defaults you did not send
• Does not decide what to work on: a score is an input to that decision
• Does not store the score or the item
• Ranking a shortlist of options against each other — use business.decision_matrix
• Any scoring where the score should move when other items appear
• Free-form judgement that cannot be written as weighted criteria

How to call

POST /v1/execute (requires authentication)

{
  "skillKey": "business.priority_score",
  "input": {
    "item": {
      "values": {
        "impact": 8,
        "reach": 1000,
        "effort": 3
      },
      "id": "TCK-4711"
    },
    "weights": [
      {
        "criterion": "impact",
        "weight": 0.5,
        "scale": {
          "min": 0,
          "max": 10
        }
      },
      {
        "criterion": "effort",
        "weight": 0.3,
        "direction": "LOWER_IS_BETTER",
        "scale": {
          "min": 0,
          "max": 10
        }
      },
      {
        "criterion": "reach",
        "weight": 0.2,
        "scale": {
          "min": 0,
          "max": 2000
        }
      }
    ]
  }
}

Examples

{
  "item": {
    "values": {
      "impact": 8,
      "reach": 1000,
      "effort": 3
    },
    "id": "TCK-4711"
  },
  "weights": [
    {
      "criterion": "impact",
      "weight": 0.5,
      "scale": {
        "min": 0,
        "max": 10
      }
    },
    {
      "criterion": "effort",
      "weight": 0.3,
      "direction": "LOWER_IS_BETTER",
      "scale": {
        "min": 0,
        "max": 10
      }
    },
    {
      "criterion": "reach",
      "weight": 0.2,
      "scale": {
        "min": 0,
        "max": 2000
      }
    }
  ]
}

{
  "score": 0.41,
  "itemId": "TCK-4711",
  "criteriaUsed": 3,
  "breakdown": [
    {
      "criterion": "impact",
      "rawValue": 8,
      "scaledValue": 0.8,
      "weight": 0.5,
      "normalizedWeight": 0.5,
      "contribution": 0.4,
      "direction": "HIGHER_IS_BETTER"
    },
    {
      "criterion": "effort",
      "rawValue": 3,
      "scaledValue": -0.3,
      "weight": 0.3,
      "normalizedWeight": 0.3,
      "contribution": -0.09,
      "direction": "LOWER_IS_BETTER"
    },
    {
      "criterion": "reach",
      "rawValue": 1000,
      "scaledValue": 0.5,
      "weight": 0.2,
      "normalizedWeight": 0.2,
      "contribution": 0.1,
      "direction": "HIGHER_IS_BETTER"
    }
  ],
  "criteriaSkipped": [],
  "weightTotal": 1
}

{
  "weights": [
    {
      "criterion": "impact",
      "weight": 2,
      "scale": {
        "min": 0,
        "max": 10
      }
    },
    {
      "criterion": "effort",
      "weight": 1,
      "missing": "SKIP"
    },
    {
      "criterion": "risk",
      "weight": 1,
      "missing": "ZERO"
    }
  ],
  "normalizeWeights": false,
  "item": {
    "values": {
      "impact": 12
    }
  }
}

{
  "breakdown": [
    {
      "criterion": "impact",
      "rawValue": 12,
      "scaledValue": 1,
      "weight": 2,
      "normalizedWeight": 2,
      "contribution": 2,
      "direction": "HIGHER_IS_BETTER",
      "note": "VALUE_CLAMPED_TO_RUBRIC"
    },
    {
      "criterion": "risk",
      "rawValue": 0,
      "scaledValue": 0,
      "weight": 1,
      "normalizedWeight": 1,
      "contribution": 0,
      "direction": "HIGHER_IS_BETTER",
      "note": "MISSING_TREATED_AS_ZERO"
    }
  ],
  "score": 2,
  "weightTotal": 3,
  "criteriaUsed": 2,
  "criteriaSkipped": [
    "effort"
  ]
}

Recommended use cases

• Score a ticket or a request the same way every time, so two people agree on the number
• Publish the arithmetic behind a priority to whoever asks why
• Keep one rubric in configuration and score against it from several services
• Score an item whose data is incomplete, deliberately and visibly

Avoid for

• Ranking a shortlist of options against each other — use business.decision_matrix
• Any scoring where the score should move when other items appear
• Free-form judgement that cannot be written as weighted criteria

Related skills

Composable with

Safety & privacy

• Runs without calling any external service.
• Your payloads are never stored permanently.
• Telemetry captures metadata only — never your payload contents.
• We never train models on your payloads.
• No human reviews your payloads.

Tags