CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

add-connector

Use when adding a Power Platform connector to an Expo/React Native Power Apps mobile app and no dedicated mobile connector skill exists.

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./plugins/mobile-apps/skills/add-connector/SKILL.md
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 strongly operational skill body: exact commands, a complete parameter reference, explicit delegation and early-return branches, and a real validation feedback loop around the build. The main weaknesses are repeated bash guard boilerplate and dense, repetitive scope-approval prose, plus inconsistent reference path styles.

DimensionReasoningScore

Conciseness

The body is dense and operational — commands, routing tables, and guard conditions with no concept padding — but the `cd -- '<working_dir>' || exit 1` boilerplate is repeated verbatim in eight bash blocks, and the invocation-scope prose ("An approved child reuses only its owner's current scope...") is repetitive legalese that could be tightened. Anchor 3 ("mostly efficient but includes some unnecessary explanation or could be tightened") fits; not 4 because the repeated guard boilerplate and duplicated scope language are more than minor.

3 / 5

Actionability

Fully executable guidance throughout: exact CLI commands per connector shape (`$PA app add data-source`, `connection list-datasets`, `list-procedures`), a complete parameter reference, a delegation table with connector API-name aliases, concrete grep patterns with file paths, and a per-file inspection list. Specific commands cover the common cases (action-style, table-based, SQL stored procedures). Clear match to anchor 5.

5 / 5

Workflow Clarity

A six-step workflow with a summary checklist, telemetry checkpoints, BLOCKED guards on every shell block, and an explicit validate-fix-retry loop in Step 5 (`npx --no-install tsc --noEmit` followed by "Fix TypeScript errors before proceeding"). Removal, refresh, and cloud-flow branches return early with explicit stop conditions. Matches anchor 5 ("clear sequence with explicit validation steps; feedback loops for error recovery; checklists for complex processes").

5 / 5

Progressive Disclosure

Detailed material (connector reference, data-source removal, dependency planning, working-directory resolution) is delegated one level deep to clearly linked files, keeping the body to workflow plus routing — good structure per anchor 4. Not anchor 5 because the same shared files are referenced with inconsistent path notation (`${PLUGIN_ROOT}/shared/...` vs `../../shared/...`), and no local references/ or scripts/ bundle exists here to verify the referenced targets against.

4 / 5

Total

17

/

20

Passed

Description

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

The description is highly distinctive with an explicit, well-conditioned trigger, but it is trigger-only: the skill's actual capabilities are never stated, so a reader must open the body to learn what the skill does. Trigger synonym coverage (data source, connection, specific connector names) is also thin.

Suggestions

Add an explicit capability statement before the trigger, e.g. "Adds Power Platform connectors to an Expo/React Native Power Apps mobile app: resolves connections, discovers datasets/tables/procedures, generates typed service files, and verifies the build. Use when...".

Include natural trigger synonyms users would actually say, such as "add a data source", "connect to SharePoint/SQL/Dataverse/Teams", or "create a connection", so the skill surfaces for those phrasings.

DimensionReasoningScore

Specificity

"adding a Power Platform connector to an Expo/React Native Power Apps mobile app" names the domain and a single concrete action, but the description lists no other capabilities (connection resolution, dataset/table discovery, generated services, schema regeneration). Anchor 3 ("names domain and 1-2 concrete actions, but not comprehensive") is the closest fit; it is above anchor 2 because the action is concrete rather than generic, and below anchor 4 because there are not several specific actions.

3 / 5

Completeness

The "when" is explicit and even conditional ("and no dedicated mobile connector skill exists"), but the "what" is only implied by the action verb inside the trigger clause — no separate statement of what the skill does (discover connections, generate typed services, verify the build). Falls between anchor 3 and anchor 4; not 5 because the "what" lacks explicit capability phrasing with concrete triggers.

4 / 5

Trigger Term Quality

Natural phrases a user would say are present ("adding a Power Platform connector", "Power Apps mobile app"), but common variations and synonyms are missing — e.g. "data source", "connection", and specific connector names like SharePoint, SQL, Dataverse, or Teams. Matches anchor 3 ("some relevant keywords but missing common variations or synonyms"); not anchor 4 because the synonym coverage is thin.

3 / 5

Distinctiveness Conflict Risk

The niche is highly specific (Power Platform connectors in an Expo/React Native Power Apps mobile app) and the clause "no dedicated mobile connector skill exists" explicitly disambiguates it from the dedicated /add-* connector skills. Clear match to anchor 5 ("clear niche with distinct triggers; minimal conflict risk").

5 / 5

Total

15

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 4 missing, 4 deeper-than-1-level, 7 suspicious

Warning

Total

13

/

16

Passed

Repository

microsoft/power-platform-skills

Path

plugins/mobile-apps/skills/add-connector/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.