A repository of Agent Skills definitions for Coupler.io integrations, with tooling to generate and validate skill indexes
Three tools with minimal documentation. All have basic descriptions (40-80 chars, below the 194-char baseline), but lack parameter descriptions entirely. Input schemas present but sparse: only 1-2 string parameters per tool, no enums, no constraints, no output schemas documented. No error handling guidance. Tool names are verb-noun (good), but descriptions do not explain WHEN to use each tool or what happens on failure. Composition is reasonable (list → get → run), but missing chaining IDs and pagination.
Run a SQL query against a Coupler dataset snapshot and return the result rows
List datasets from a Coupler dataflow, returning dataset information including snapshot IDs and last success run timestamps
Trigger a run of a Coupler dataflow to refresh its data
No parameter descriptions. 'dataflow_id' and 'dataset_snapshot_id' lack context, LLMs cannot infer whether these are UUIDs, slugs, or numeric IDs, or how to obtain them.
No output schemas documented. Callers cannot plan downstream tool calls or extract required fields (e.g., does list-datasets return snapshot IDs that get-data needs?).
Tool descriptions are too brief (30 - 80 chars vs. 194-char baseline). 'Run a SQL query' does not explain prerequisites, error modes, or when to call this vs. list-datasets.
No error handling guidance. If run-dataflow fails, LLM has no recovery path. If get-data returns no rows, is that an error or success?
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 49 | 2026-07-28+ | v2 |
get-data accepts free-form SQL with no validation hints. LLMs may hallucinate invalid syntax or attempt injection. No mention of query limits, timeout, or result row caps.