Rewrite skill descriptions to follow best practices (#90)#92
Merged
priyanshu92 merged 1 commit intomainfrom Apr 17, 2026
Merged
Rewrite skill descriptions to follow best practices (#90)#92priyanshu92 merged 1 commit intomainfrom
priyanshu92 merged 1 commit intomainfrom
Conversation
Collaborator
priyanshu92
commented
Apr 16, 2026
- 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>
Contributor
There was a problem hiding this comment.
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
descriptionfields across multiple Power Pages skills to be action-led, concise, and consistent. - Standardizes skill
descriptionYAML block scalars to>-format. - Bumps
plugins/power-pagesplugin version from1.2.1to1.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.
ashishchoudhary001
approved these changes
Apr 17, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.