CtrlK
BlogDocsLog inGet started
Tessl Logo

hefgi/shortcut

Interact with Shortcut - view, search, update, and create stories, epics, objectives, iterations, docs, labels, and teams using the short CLI. IMPORTANT - When you see URLs matching `app.shortcut.com/*`, use this skill instead of WebFetch.

91

1.88x
Quality

99%

Does it follow best practices?

Impact

81%

1.88x

Average score across 5 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

Overview
Quality
Evals
Security
Files

criteria.jsonevals/scenario-2/

{
  "context": "Tests whether the agent correctly verifies CLI prerequisites, handles the case where the CLI is absent or outdated, avoids auto-installing software, and handles error conditions including auth failures and Node.js version requirements.",
  "type": "weighted_checklist",
  "checklist": [
    {
      "name": "Version check command",
      "description": "Uses `which short && short --version` (or an equivalent two-step command) to check for the CLI and its version",
      "max_score": 10
    },
    {
      "name": "No auto-install",
      "description": "Does NOT automatically run any install command (e.g., brew install, npm install) when the CLI is missing; only shows installation instructions",
      "max_score": 12
    },
    {
      "name": "Upgrade command accuracy",
      "description": "When version < 5.0.0, provides BOTH the brew upgrade command (`brew upgrade shortcut-cli`) AND the npm update command (`npm update -g @shortcut-cli/shortcut-cli`)",
      "max_score": 8
    },
    {
      "name": "Stop after missing CLI",
      "description": "When CLI is not found, the documented flow STOPS after showing installation instructions rather than attempting to continue with Shortcut operations",
      "max_score": 10
    },
    {
      "name": "Auth failure guidance",
      "description": "For an 'unauthorized' or 'invalid token' error, directs the user to run `short install` (not other commands like `short auth` or `short login`)",
      "max_score": 10
    },
    {
      "name": "Not-found ID handling",
      "description": "When a story/epic returns 'not found', the response both confirms the ID used AND suggests using search to find the item",
      "max_score": 8
    },
    {
      "name": "Node.js version requirement",
      "description": "ESM/import errors or 'unsupported engine' output is attributed to Node.js version and the response states Node.js >= 20.19.0 is required",
      "max_score": 10
    },
    {
      "name": "Network error guidance",
      "description": "A timeout or connection error results in guidance to check the network connection (not to retry automatically)",
      "max_score": 7
    },
    {
      "name": "Prerequisite check before operation",
      "description": "The script/plan checks prerequisites BEFORE attempting any Shortcut data operation",
      "max_score": 10
    },
    {
      "name": "Minimum Node version stated",
      "description": "Installation instructions include the minimum Node.js version requirement (20.19.0)",
      "max_score": 8
    },
    {
      "name": "Homebrew install shown",
      "description": "Installation instructions include the Homebrew option (`brew install shortcut-cli`)",
      "max_score": 7
    }
  ]
}

evals

SKILL.md

tile.json