CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

list-connections

Lists Power Platform connections in the current environment. Use when you need a connection ID before adding a connector to a code app.

Quality

91%

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

100%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.

An exemplary lean skill body: a simple two-step workflow made fully executable with concrete commands, an exact URL template, and explicit error-handling branches including retry-once limits and STOP conditions. Cross-cutting concerns are properly offloaded to shared one-level-deep references.

DimensionReasoningScore

Conciseness

The ~30-line body has no concept explanations or padding; every section is actionable and the one-line workflow map plus intro each carry unique information (CLI name, step overview). Closest anchor: 'Lean and efficient; every token earns its place.'

5 / 5

Actionability

Fully executable guidance: copy-paste command ('pa connection list'), the exact flag usage ('-c <connection-id>'), a concrete URL pattern with the environment-ID placeholder, and specific error-path instructions (retry once, STOP, report exact output). Matches the top anchor.

5 / 5

Workflow Clarity

Two steps are explicitly sequenced with validation checkpoints and feedback loops: auth retry, verify environment ID in power.config.json then retry once, STOP on non-auth failures, and a create-connector-then-re-run loop. This is a read-only single-purpose skill, so no destructive/batch cap applies and the simple-skill exception holds.

5 / 5

Progressive Disclosure

Under 50 lines with well-organized sections; cross-cutting detail (CLI resolution, shared instructions) is correctly split into clearly signaled, one-level-deep references. No bundle files exist in this skill, and none are needed for this scope.

5 / 5

Total

20

/

20

Passed

Description

82%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: third-person, concise, with an explicit and specific 'Use when' clause tied to a concrete need (connection ID before adding a connector). Its only weakness is limited action coverage — it names the single 'list' action without hinting at the fuller workflow (presenting IDs, handling missing connectors).

Suggestions

Add one or two more concrete actions to the 'what' clause, e.g. 'Lists Power Platform connections in the current environment and surfaces the connection ID needed for data sources.'

Include a natural synonym already used by the body, such as 'data source', to broaden trigger coverage for users who ask about adding data sources.

DimensionReasoningScore

Specificity

The description names the domain ('Power Platform connections') and one concrete action ('Lists ... in the current environment'), which matches the 1-2-concrete-actions anchor. It is not comprehensive — no mention of presenting connection IDs or resolving missing connectors — so it falls short of anchor 4.

3 / 5

Completeness

It explicitly answers both 'what' ('Lists Power Platform connections in the current environment') and 'when' ('Use when you need a connection ID before adding a connector to a code app') with a concrete trigger condition, matching the top anchor.

5 / 5

Trigger Term Quality

Terms like 'Power Platform', 'connections', 'connection ID', and 'connector' are natural phrasings users would say in this domain. A few natural variations are missing (e.g. 'data source', which the skill body itself uses), so it sits between anchors 4 and 5, closer to 4.

4 / 5

Distinctiveness Conflict Risk

A clear niche (listing Power Platform connections to obtain connection IDs) with distinct triggers and minimal risk of firing for unrelated skills.

5 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 2 missing, 2 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

microsoft/power-platform-skills

Path

plugins/code-apps/skills/list-connections/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.