Skip to content

How a-Shell’s scores are calculated

The full audit trail, recomputed from the verdict data at build time through the same code that produced the leaderboard: verdict × quality × story weight per cell, cells sum to dimension scores, dimensions blend into the PA Score. Every number on the product page is reproducible from this page alone; for why the formula looks like this, see the methodology.

verdict factors: full ×1.0 · partial ×0.6 · disputed ×0.3 · none ×0.0 · n/a excluded from both sides · cell points = weight × quality × factor · cell max = weight × 10

PA Score4/100

Agent-ready 4.8 × 0.30 = 1.44

API quality 0.0 × 0.20 = 0.00

Openness 9.6 × 0.20 = 1.92

Built-in AI 0.0 × 0.15 = 0.00

Automation 4.5 × 0.15 = 0.67

(1.44 + 0.00 + 1.92 + 0.00 + 0.67) ÷ (0.30 + 0.20 + 0.20 + 0.15 + 0.15) = 4.04 ÷ 1.00 = 4.0

Scores are stored to 1 decimal; the product page’s pills round to whole numbers for display. Each dimension below shows the stories, verdicts, and cited evidence behind its number.

Agent-ready4.8/100×0.30 of the PA blend

Outside-in: can YOUR agent reach and drive this product — API, MCP, CLI, headless runs, agent docs.

Point an agent at llms.txt or agent-oriented docsweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [probe] https://holzschu.github.io/llms.txtPROBE llms.txt: HTTP 404 at https://holzschu.github.io/llms.txt
  • [probe] https://holzschu.github.io/openapi.jsonPROBE openapi: all candidate paths 404 (https://holzschu.github.io/openapi.json, https://holzschu.github.io/swagger.json, https://holzschu.github.io/api/openapi.json, https://holzschu.github.io/.well-known/openapi.json)
  • [github] https://github.com/holzschu/a-shellFor help, type `help` in the command line. `help -l` lists all the available commands. `help -l | grep command` will tell you if your favorite command is already installed.

Run the product headlessly / in CI for automationweight 2

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Plug MCP servers into this product so it can use their toolsweight 3

3 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 30 max

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Connect an agent via an official MCP serverweight 3

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Use an official CLIweight 2

2 (weight) × 4 (quality) × 0.6 (partial) = 4.8 of 20 max

  • [github] https://github.com/holzschu/a-shella-Shell is compatible with Apple Shortcuts, giving users full control of the Shell. You can write complex Shortcuts to download, process and release files using a-Shell commands.
  • [github] https://github.com/holzschu/a-shellFor help, type `help` in the command line. `help -l` lists all the available commands. `help -l | grep command` will tell you if your favorite command is already installed.
  • [claimed-docs] https://holzschu.github.io/a-Shell_iOS/Use 'pip install' to add more Python packages (if they are pure Python).

Drive the product through a documented public APIweight 3

3 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 30 max

  • [probe] https://holzschu.github.io/llms.txtPROBE llms.txt: HTTP 404 at https://holzschu.github.io/llms.txt
  • [probe] https://holzschu.github.io/openapi.jsonPROBE openapi: all candidate paths 404 (https://holzschu.github.io/openapi.json, https://holzschu.github.io/swagger.json, https://holzschu.github.io/api/openapi.json, https://holzschu.github.io/.well-known/openapi.json)
  • [github] https://github.com/holzschu/a-shella-Shell is compatible with Apple Shortcuts, giving users full control of the Shell. You can write complex Shortcuts to download, process and release files using a-Shell commands.

Issue scoped/least-privilege API credentials for an agentweight 2

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Build against official SDKsweight 2

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Subscribe to events via webhooksweight 2

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Agent-ready = 4.8 ÷ 100 × 100 = 4.8

API quality0.0/100×0.20 of the PA blend

The programmable surface once an agent is there — machine-readable spec, interactive docs, sandbox, versioning discipline.

Explore an interactive API reference with runnable examplesweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [probe] https://holzschu.github.io/llms.txtPROBE llms.txt: HTTP 404 at https://holzschu.github.io/llms.txt
  • [probe] https://holzschu.github.io/openapi.jsonPROBE openapi: all candidate paths 404 (https://holzschu.github.io/openapi.json, https://holzschu.github.io/swagger.json, https://holzschu.github.io/api/openapi.json, https://holzschu.github.io/.well-known/openapi.json)
  • [github] https://github.com/holzschu/a-shellFor help, type `help` in the command line. `help -l` lists all the available commands. `help -l | grep command` will tell you if your favorite command is already installed.

Download a machine-readable API spec (OpenAPI or equivalent)weight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [probe] https://holzschu.github.io/llms.txtPROBE llms.txt: HTTP 404 at https://holzschu.github.io/llms.txt
  • [probe] https://holzschu.github.io/openapi.jsonPROBE openapi: all candidate paths 404 (https://holzschu.github.io/openapi.json, https://holzschu.github.io/swagger.json, https://holzschu.github.io/api/openapi.json, https://holzschu.github.io/.well-known/openapi.json)

Test against a sandbox environment without touching production dataweight 1

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Rely on versioned APIs with a documented deprecation policyweight 2

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

API quality = 0.0 ÷ 40 × 100 = 0.0

Openness9.6/100×0.20 of the PA blend

Can you leave, inspect, or self-host — data export, open source, portability.

Do everything through the API that I can do in the UIweight 2

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Export all of my data in open formats and leaveweight 3

3 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 30 max

  • [github] https://github.com/holzschu/a-shellEach window has its own context, appearance, command history and current directory. `newWindow` opens a new window, `exit` closes the current window.
  • [github] https://github.com/holzschu/a-shellYou can also bookmark the current directory with `bookmark`. `showmarks` will list all the existing bookmarks, `jump mark` and `cd ~mark` will change the current directory to this specific bookmark.
  • [probe] https://holzschu.github.io/llms.txtPROBE llms.txt: HTTP 404 at https://holzschu.github.io/llms.txt
  • [probe] https://holzschu.github.io/openapi.jsonPROBE openapi: all candidate paths 404 (https://holzschu.github.io/openapi.json, https://holzschu.github.io/swagger.json, https://holzschu.github.io/api/openapi.json, https://holzschu.github.io/.well-known/openapi.json)

Read the product's source under an open licenseweight 2

2 (weight) × 4 (quality) × 0.6 (partial) = 4.8 of 20 max

  • [github] https://github.com/holzschu/a-shellEach window has its own context, appearance, command history and current directory. `newWindow` opens a new window, `exit` closes the current window.
  • [github] https://github.com/holzschu/a-shellFor help, type `help` in the command line. `help -l` lists all the available commands. `help -l | grep command` will tell you if your favorite command is already installed.

Self-host the core productweight 3

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Openness = 4.8 ÷ 50 × 100 = 9.6

Built-in AI0.0/100×0.15 of the PA blend

Inside-out: how agentic the product itself is for its users — built-in assistants, autonomous features.

Get AI-generated insights and suggestions from my data inside the productweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Set up automations that run autonomously in the backgroundweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Delegate tasks to a built-in AI assistant inside the productweight 3

3 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 30 max

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Operate the product with natural-language commandsweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [github] https://github.com/holzschu/a-shellFor help, type `help` in the command line. `help -l` lists all the available commands. `help -l | grep command` will tell you if your favorite command is already installed.
  • [probe] https://holzschu.github.io/llms.txtPROBE llms.txt: HTTP 404 at https://holzschu.github.io/llms.txt
  • [probe] https://holzschu.github.io/openapi.jsonPROBE openapi: all candidate paths 404 (https://holzschu.github.io/openapi.json, https://holzschu.github.io/swagger.json, https://holzschu.github.io/api/openapi.json, https://holzschu.github.io/.well-known/openapi.json)

Built-in AI = 0.0 ÷ 90 × 100 = 0.0

Automation4.5/100×0.15 of the PA blend

Depth of automation primitives — rules, scheduling, bulk operations, webhooks.

Perform bulk operations across many items at onceweight 2

2 (weight) × 3 (quality) × 0.6 (partial) = 3.6 of 20 max

  • [github] https://github.com/holzschu/a-shella-Shell is compatible with Apple Shortcuts, giving users full control of the Shell. You can write complex Shortcuts to download, process and release files using a-Shell commands.
  • [github] https://github.com/holzschu/a-shellFor help, type `help` in the command line. `help -l` lists all the available commands. `help -l | grep command` will tell you if your favorite command is already installed.

Define rules that trigger actions automatically on eventsweight 3

3 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 30 max

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Schedule recurring jobs or workflowsweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Version, review, and roll back my automationsweight 1

1 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 10 max

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Automation = 3.6 ÷ 80 × 100 = 4.5