CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bigquery-data-transfer-service

Discovers and inspects BigQuery Data Transfer Service (DTS) configurations. Use this to identify existing ingestion pipelines and extract datasource or transfer config metadata for data pipelines. Use when a user asks for ingestion scenarios while building or managing data pipelines or when a user asks to "ingest" or "add" data that may already be managed by a DTS transfer.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured operational workflow with executable commands, mandatory user-confirmation checkpoints, a polling/timeout feedback loop, and a Definition of Done checklist — matching the bundle's actual single-script layout. The main improvement opportunities are trimming padded emphasis callouts and moving detail like the OAuth flow into a reference file.

Suggestions

Trim the repeated MUST/IMPORTANT emphasis and the fully scripted timeout message to their operative instructions; the surrounding structure already conveys the mandatory nature.

Move the OAuth/EUC authorization flow and the mandatory parameter questionnaire into a reference file (e.g., references/oauth-flow.md) and link to it from Step 2 to keep SKILL.md as a lean overview.

Show or link the expected `deployment.yaml` structure (or the "gcp pipeline resource provisioning" framework's docs) so the declarative provisioning step is as actionable as the CLI steps.

DimensionReasoningScore

Conciseness

The body is command-first with no teaching of concepts Claude already knows, but there is padding that could be trimmed: repeated MUST/IMPORTANT emphasis callouts, a fully scripted user-facing timeout message, and a verbose OAuth/EUC explanation ("meaning the user is using End User Credentials or EUC to configure the transfer config"). Not 5 because these sections are noticeably looser than the lean command blocks; not 3 because there is no unnecessary conceptual explanation overall.

4 / 5

Actionability

Mostly executable, copy-paste-ready commands throughout — `gcloud config get project`, `bq ls --transfer_config`, `python3 scripts/bigquery_dts.py --project_id=<PROJECT_ID> <DATA_SOURCE_ID> <REGION>`, `bq mk --transfer_run ...` — and the referenced script exists with a matching CLI interface. Minor gaps keep it below 5: the OAuth URI generation step and the `deployment.yaml`/"gcp pipeline resource provisioning" format are referenced but never shown or linked, and "Attempt to guess the correct one based on context" is soft guidance. Not 3 because the guidance is concrete and executable, not pseudocode.

4 / 5

Workflow Clarity

Clear sequenced workflow (Step 0 environment discovery → Step 1 existing-transfer check → Step 2 parameter discovery/user validation → Step 3 config extraction → Step 4 trigger/verify) with explicit validation checkpoints: "You MUST NOT proceed until parameters are confirmed", the 5-minute polling rule with success/failure/timeout branches, a STOP-and-ask fallback, and a Definition of Done checklist. Error recovery ("If the run fails, analyze the logs and ask the user for help") closes the loop, so the destructive/batch cap does not apply. Clearly matches the anchor-5 pattern of validate → branch → proceed only when valid.

5 / 5

Progressive Disclosure

Good structure against the actual bundle: the only bundle file, `scripts/bigquery_dts.py`, is referenced one level deep with clear usage examples and its interface matches the body. Not 5 because the ~180-line body inlines everything — the OAuth authorization flow and the mandatory parameter questionnaire in particular would fit naturally in a separate reference file; not 3 because the single reference that exists is clearly signaled and navigation is easy.

4 / 5

Total

17

/

20

Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it states concrete capabilities in third person, gives an explicit 'Use when' clause with natural quoted trigger verbs, and scopes itself narrowly to DTS-managed ingestion. Its only weaknesses are slightly incomplete action coverage and missing synonyms like 'load' or 'import'.

DimensionReasoningScore

Specificity

Names the domain and several concrete actions — "Discovers and inspects BigQuery Data Transfer Service (DTS) configurations", "identify existing ingestion pipelines", "extract datasource or transfer config metadata" — with only a minor gap: it omits the provisioning/verification actions the skill body actually performs. Not 5 because coverage of the skill's full capability set is incomplete; not 3 because it lists more than 1-2 specific actions.

4 / 5

Completeness

Explicitly answers both: "what" (discover/inspect DTS configurations, identify ingestion pipelines, extract transfer config metadata) and "when" with a concrete "Use when..." clause containing quoted trigger phrases ("ingest", "add"). Uses third-person voice ("Discovers and inspects"). Clearly matches the anchor-5 example structure; a 4 would require the 'when' to be less explicit than it is.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "ingestion scenarios", "building or managing data pipelines", and the explicitly quoted user verbs "ingest" or "add" data, plus the product name users would mention. Not 5 because common synonyms like "load", "import", or "ETL" are missing; not 3 because multiple natural phrases a user would actually say are present.

4 / 5

Distinctiveness Conflict Risk

The DTS-specific trigger condition — data that "may already be managed by a DTS transfer" — carves out a clear niche with distinct triggers. Not 5 because broader phrases like "ingestion scenarios" and "data pipelines" could overlap with sibling BigQuery/data-ingestion skills; not 3 because the DTS qualifier keeps the overlap minor and closely related rather than broad.

4 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

saski/arnesto

Path

.agents/skills/bigquery-data-transfer-service/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.