CtrlK
BlogDocsLog inGet started
Tessl Logo

uinaf/docs

Audit and update repository documentation, agent guidance, specifications, decisions, and runbooks while keeping tactical plans and tracker work out of the documentation surface.

99

1.11x
Quality

Does it follow best practices?

Impact

99%

1.11x

Average score across 6 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Overview
Quality
Evals
Security
Files

criteria.jsonevals/scenario-4/

{
  "context": "Tests whether the docs skill rewrites verbose operational documentation for agent retrieval: current supported state first, complete operational facts, no irrelevant negative inventory or history, and precise decision-changing limitations paired with a valid path.",
  "type": "weighted_checklist",
  "checklist": [
    {
      "name": "Current runtime leads",
      "description": "docs/runtime.md leads with the current worker/runtime contract rather than historical background or a list of unavailable systems",
      "max_score": 10
    },
    {
      "name": "Start and health commands preserved",
      "description": "docs/runtime.md preserves the exact `pnpm run scheduler` and `curl http://127.0.0.1:6120/status` commands",
      "max_score": 10
    },
    {
      "name": "Current configuration preserved",
      "description": "docs/runtime.md maps `RUN_STORE_PATH`, `ARTIFACT_DIR`, and `SMTP_URL` to run records, generated artifacts, and completion or failure notices",
      "max_score": 10
    },
    {
      "name": "Owned paths preserved",
      "description": "docs/runtime.md preserves `src/scheduler/main.ts` as the entrypoint and `src/runs/repository.ts` as run persistence",
      "max_score": 8
    },
    {
      "name": "Recovery path preserved",
      "description": "docs/runtime.md keeps the `artifact write failed` recovery guidance and exact `pnpm run scheduler:retry -- <run-id>` command",
      "max_score": 10
    },
    {
      "name": "Negative inventory removed",
      "description": "docs/runtime.md omits `SENTRY_DSN`, `PAGERDUTY_TOKEN`, `DATADOG_API_KEY`, `PROMETHEUS_URL`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `LOKI_URL`, the named observability-system inventory, and its categorical restatement about hosted log search, metrics scraping, or a telemetry collector",
      "max_score": 12
    },
    {
      "name": "Historical narrative removed",
      "description": "docs/runtime.md omits the 2023/2025 CloudWatch and Splunk migration story and the closing historical recap",
      "max_score": 8
    },
    {
      "name": "Decision-changing limitation retained",
      "description": "docs/runtime.md states that live log streaming is unsupported and pairs the boundary with paging `GET /v2/runs/:id/logs?after=<cursor>` every 5 seconds",
      "max_score": 12
    },
    {
      "name": "Agent-first structure and budget",
      "description": "docs/runtime.md has at most 45 non-empty lines and uses task-shaped headings, bullets or mappings, and compact command blocks instead of novel-like paragraphs",
      "max_score": 10
    },
    {
      "name": "Report and factual restraint",
      "description": "doc-report.md identifies preserved operational facts, removed context debt, and verification; neither output invents capabilities, commands, paths, or configuration",
      "max_score": 10
    }
  ]
}

SKILL.md

tile.json