Skip to content

Rewrite skill descriptions to follow best practices (#90)#92

Merged
priyanshu92 merged 1 commit intomainfrom
users/priyanshuag/improve-skill-descriptions
Apr 17, 2026
Merged

Rewrite skill descriptions to follow best practices (#90)#92
priyanshu92 merged 1 commit intomainfrom
users/priyanshuag/improve-skill-descriptions

Conversation

@priyanshu92
Copy link
Copy Markdown
Collaborator

  • Use third-person voice instead of "This skill should be used when..."
  • Lead with what the skill does, then when to use it
  • Remove bloated quoted trigger-phrase lists
  • Standardize YAML block scalar to >- across all skills
  • Bump plugin version to 1.2.2

- Use third-person voice instead of "This skill should be used when..."
- Lead with what the skill does, then when to use it
- Remove bloated quoted trigger-phrase lists
- Standardize YAML block scalar to >- across all skills
- Bump plugin version to 1.2.2

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@priyanshu92 priyanshu92 requested a review from a team as a code owner April 16, 2026 13:48
Copilot AI review requested due to automatic review settings April 16, 2026 13:48
@priyanshu92 priyanshu92 enabled auto-merge (squash) April 16, 2026 13:48
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates Power Pages skill frontmatter descriptions to align with current writing best practices (third-person, action-first, concise “Use when…” guidance) and bumps the Power Pages plugin version.

Changes:

  • Rewrites description fields across multiple Power Pages skills to be action-led, concise, and consistent.
  • Standardizes skill description YAML block scalars to >- format.
  • Bumps plugins/power-pages plugin version from 1.2.1 to 1.2.2.

Reviewed changes

Copilot reviewed 15 out of 15 changed files in this pull request and generated no comments.

Show a summary per file
File Description
plugins/power-pages/skills/test-site/SKILL.md Updates skill description to concise action-first wording and >- scalar.
plugins/power-pages/skills/setup-datamodel/SKILL.md Rewrites description to action-first “creates…” phrasing and >- scalar.
plugins/power-pages/skills/setup-auth/SKILL.md Rewrites description with clearer scope and “Use when…” guidance.
plugins/power-pages/skills/integrate-webapi/SKILL.md Rewrites description to summarize lifecycle and intent concisely.
plugins/power-pages/skills/integrate-backend/SKILL.md Rewrites description to emphasize recommendation/routing role and usage.
plugins/power-pages/skills/deploy-site/SKILL.md Converts single-line description to folded block with clearer steps.
plugins/power-pages/skills/create-webroles/SKILL.md Rewrites description to summarize outcomes and usage triggers.
plugins/power-pages/skills/create-site/SKILL.md Rewrites description to summarize end-to-end orchestration and usage.
plugins/power-pages/skills/audit-permissions/SKILL.md Removes trigger phrase list; replaces with concise “Use when…” guidance.
plugins/power-pages/skills/add-server-logic/SKILL.md Rewrites description to summarize lifecycle and typical user intent.
plugins/power-pages/skills/add-seo/SKILL.md Rewrites description to list SEO outputs and usage conditions.
plugins/power-pages/skills/add-sample-data/SKILL.md Rewrites description to concise “populates…” phrasing and usage.
plugins/power-pages/skills/add-cloud-flow/SKILL.md Rewrites description to cover new + already-registered flow integration.
plugins/power-pages/skills/activate-site/SKILL.md Rewrites description to action-first wording and “Use when…” guidance.
plugins/power-pages/.claude-plugin/plugin.json Bumps plugin version to 1.2.2.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@priyanshu92 priyanshu92 disabled auto-merge April 16, 2026 13:53
Comment thread plugins/power-pages/skills/activate-site/SKILL.md
@priyanshu92 priyanshu92 merged commit 4930073 into main Apr 17, 2026
10 checks passed
@priyanshu92 priyanshu92 deleted the users/priyanshuag/improve-skill-descriptions branch April 17, 2026 11:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants