CtrlK
BlogDocsLog inGet started
Tessl Logo

akshay-babbar/doc-sync

Auto-syncs stale docstrings and README when function signatures change. Detects documentation drift after refactors, parameter additions, or return type changes. Dry-run by default — proposes before writing.

87

1.59x
Quality

100%

Does it follow best practices?

Impact

86%

1.59x

Average score across 17 eval scenarios

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

criteria.jsonevals/scenario-11/

{
  "context": "Tests whether the agent makes a minimal, surgical docstring edit — adding only the new timeout parameter documentation while leaving the Examples, Notes, See Also, Raises, and Returns sections completely untouched.",
  "type": "weighted_checklist",
  "checklist": [
    {
      "name": "Timeout param documented",
      "description": "src/connection.py docstring Args section contains a line documenting the timeout parameter (e.g. 'timeout: Connection timeout in seconds.')",
      "max_score": 30
    },
    {
      "name": "Examples section preserved",
      "description": "src/connection.py docstring still contains the exact Examples section with `>>> conn = connect(\"localhost\", 8080)` and `>>> conn.send(b\"ping\")` unchanged",
      "max_score": 45
    },
    {
      "name": "Notes section preserved",
      "description": "src/connection.py docstring still contains 'Connections are not thread-safe. Use one connection per thread.' unchanged",
      "max_score": 45
    },
    {
      "name": "See Also section preserved",
      "description": "src/connection.py docstring still contains the See Also section with disconnect and reconnect entries unchanged",
      "max_score": 45
    },
    {
      "name": "Existing args untouched",
      "description": "The 'host' and 'port' Args entries in the docstring are unchanged — no reordering or reformatting occurred",
      "max_score": 45
    },
    {
      "name": "Unified report format",
      "description": "doc-sync-report.md contains '## Doc Sync Report' as a top-level heading",
      "max_score": 45
    }
  ]
}

evals

README.md

SKILL.md

tessl.json

tile.json

TRUST.md