Post Draft Review
agent-substrate/substrate
Posts pull request review findings as GitHub draft (pending) inline comments for a human to edit and submit, instead of publishing them straight to the PR author.
Review PRs for declarative agent samples (da- folders) in pnp/copilot-pro-dev-samples.
Install Declarative Agent Sample Review
$ npx skills add pnp/copilot-pro-dev-samples --skill declarative-agent-sample-review -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install pnp/copilot-pro-dev-samples declarative-agent-sample-review --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/pnp/copilot-pro-dev-samples.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/declarative-agent-sample-review .claude/skills/declarative-agent-sample-review && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "declarative-agent-sample-review" agent skill from https://github.com/pnp/copilot-pro-dev-samples/tree/main/.github/skills/declarative-agent-sample-review into .claude/skills/declarative-agent-sample-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "declarative-agent-sample-review", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/pnp/copilot-pro-dev-samples/tree/main/.github/skills/declarative-agent-sample-reviewType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add pnp/copilot-pro-dev-samples --skill declarative-agent-sample-review -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install pnp/copilot-pro-dev-samples declarative-agent-sample-review --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pnp/copilot-pro-dev-samples.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.github/skills/declarative-agent-sample-review .agents/skills/declarative-agent-sample-review && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "declarative-agent-sample-review" agent skill from https://github.com/pnp/copilot-pro-dev-samples/tree/main/.github/skills/declarative-agent-sample-review into .agents/skills/declarative-agent-sample-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "declarative-agent-sample-review", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add pnp/copilot-pro-dev-samples --skill declarative-agent-sample-review -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install pnp/copilot-pro-dev-samples declarative-agent-sample-review --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pnp/copilot-pro-dev-samples.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.github/skills/declarative-agent-sample-review .cursor/skills/declarative-agent-sample-review && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "declarative-agent-sample-review" agent skill from https://github.com/pnp/copilot-pro-dev-samples/tree/main/.github/skills/declarative-agent-sample-review into .cursor/skills/declarative-agent-sample-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "declarative-agent-sample-review", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/pnp/copilot-pro-dev-samples.git --path .github/skills/declarative-agent-sample-review--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add pnp/copilot-pro-dev-samples --skill declarative-agent-sample-review -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install pnp/copilot-pro-dev-samples declarative-agent-sample-review --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pnp/copilot-pro-dev-samples.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.github/skills/declarative-agent-sample-review .gemini/skills/declarative-agent-sample-review && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "declarative-agent-sample-review" agent skill from https://github.com/pnp/copilot-pro-dev-samples/tree/main/.github/skills/declarative-agent-sample-review into .gemini/skills/declarative-agent-sample-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "declarative-agent-sample-review", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install pnp/copilot-pro-dev-samples declarative-agent-sample-reviewInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add pnp/copilot-pro-dev-samples --skill declarative-agent-sample-review -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/pnp/copilot-pro-dev-samples.git skills-src && mkdir -p .github/skills && cp -r skills-src/.github/skills/declarative-agent-sample-review .github/skills/declarative-agent-sample-review && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "declarative-agent-sample-review" agent skill from https://github.com/pnp/copilot-pro-dev-samples/tree/main/.github/skills/declarative-agent-sample-review into .github/skills/declarative-agent-sample-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "declarative-agent-sample-review", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add pnp/copilot-pro-dev-samples --skill declarative-agent-sample-review -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install pnp/copilot-pro-dev-samples declarative-agent-sample-review --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pnp/copilot-pro-dev-samples.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.github/skills/declarative-agent-sample-review .opencode/skills/declarative-agent-sample-review && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "declarative-agent-sample-review" agent skill from https://github.com/pnp/copilot-pro-dev-samples/tree/main/.github/skills/declarative-agent-sample-review into .opencode/skills/declarative-agent-sample-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "declarative-agent-sample-review", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
declarative-agent-sample-review- GitHub stars
- 167
- Token cost
- ~720 tokens
- SKILL.md length
- 207 words
- Files
- 1
- Skills in repo
- 2
- Repo updated
- First seen
- Licence
- MIT
At a glance
Review PRs for declarative agent samples (da- folders) in pnp/copilot-pro-dev-samples.
- Works in 4 steps: Manifest Schema Versions → m365agents.yml → README.md → …
- Reviewing da- sample submissions
- SKILL.md covers Workflow, Checks and Submitting Reviews
- Calls gh; reaches m365-visitor-stats.azurewebsites.net
What it does
Declarative Agent Sample Review is an agent skill from pnp/copilot-pro-dev-samples. Review PRs for declarative agent samples (da- folders) in pnp/copilot-pro-dev-samples. Use when reviewing da- sample submissions, checking manifest versions, validating README format. Triggers on "review PR", "review this sample", or PR review requests for declarative agent samples.
Its SKILL.md is about 720 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development, covering Pull requests and Technical documentation. It works with Microsoft 365. The repository describes itself as: Community contributed samples for the Microsoft 365 Copilot. Contributions welcome. The licence is MIT.
When your agent uses it
- Reviewing da- sample submissions
- Checking manifest versions
- Validating README format
- Review this sample
Example prompts
- “review PR”
- “review this sample”
- “/declarative-agent-sample-review”
Workflow steps
4 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit ddc06d2. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
gh
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
m365-visitor-stats.azurewebsites.net
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Declarative Agent Sample Review loads about 720 tokens when it runs. Until then it costs about 79 tokens; SKILL.md has 207 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from pnp/copilot-pro-dev-samples at commit ddc06d2, republished under its MIT licence (© pnp). 207 words, ~720 tokens.
Download SKILL.mdSave it as
.claude/skills/declarative-agent-sample-review/SKILL.md (or your agent's skills folder).- name
- declarative-agent-sample-review
- description
- Review PRs for declarative agent samples (da-* folders) in pnp/copilot-pro-dev-samples. Use when reviewing da-* sample submissions, checking manifest versions, validating README format. Triggers on "review PR", "review this sample", or PR review requests for declarative agent samples.
Declarative Agent Sample Review
Review declarative agent sample PRs (folders starting with da-) for compliance with repo guidelines.
Workflow
- Checkout PR:
gh pr checkout <number> - Verify sample folder starts with
da- - Run checks below, collecting comments (file, line, issue)
- Submit all comments in single API call (GitHub limitation)
Checks
1. Manifest Schema Versions
Fetch latest versions from Microsoft Learn docs (never use other samples as reference):
| Manifest | File | Property | Docs |
|---|---|---|---|
| App | appPackage/manifest.json | manifestVersion | learn.microsoft.com/microsoft-365/extensibility/schema |
| Declarative Agent | appPackage/*DeclarativeAgent.json | version + $schema | learn.microsoft.com/microsoft-365-copilot/extensibility/declarative-agent-manifest |
| API Plugin | appPackage/ai-plugin.json | schema_version | learn.microsoft.com/microsoft-365-copilot/extensibility/api-plugin-manifest |
2. m365agents.yml
- No
projectId- auto-generated on provision, must not be committed - Check both
m365agents.ymlandm365agents.local.yml
3. README.md
Compare against templates/da-declarative-agent/README.md:
- Contributors section present with actual author names
- Version history lists real author (not "Microsoft")
- Tracking image uses markdown format at end of file:
 - URLs consistent (avoid mixed
en-us/locales in same file) - No trailing
---at end
4. assets/sample.json
Compare against templates/sample-template.json:
- name:
pnp-copilot-pro-dev-<sample-folder> - url/downloadUrl: correct sample folder path
- authors: matches actual contributors (verify against PR author)
- URLs: consistent locale format
Submitting Reviews
GitHub API cannot add comments to pending reviews after creation. Collect all comments first.
Get commit SHA:
gh pr view <PR> --json headRefOidCreate review.json:
{
"commit_id": "<sha>",
"event": "REQUEST_CHANGES",
"body": "Summary message",
"comments": [
{"path": "file/path", "line": 10, "body": "Issue description"}
]
}Submit:
gh api repos/pnp/copilot-pro-dev-samples/pulls/<PR>/reviews --method POST --input review.jsonConvert to Draft
After submitting a review with requested changes, convert the PR to draft:
gh pr ready <PR> --undo© pnp, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in .github/skills/declarative-agent-sample-review of pnp/copilot-pro-dev-samples.
Open the folder on GitHubat commit ddc06d2
Compare with similar skills
Declarative Agent Sample Review next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Declarative Agent Sample Review this skillpnp/copilot-pro-dev-samples | 167 | — | ~720 | Automated safety check: Pass | MIT | |
| Post Draft Reviewagent-substrate/substrate | 4.5k | — | ~2.8k | Automated safety check: Pass | Apache-2.0 | |
| Review Kedro PRkedro-org/kedro | 11k | — | ~2.8k | Automated safety check: Pass | Custom licence | |
| Opik Documentation Patternscomet-ml/opik | 22k | — | ~1.3k | Automated safety check: Pass | Apache-2.0 | |
| Eli5coldteadotai/pr-lens | 1.9k | — | ~2.3k | Automated safety check: Pass | MIT | |
| Review PRjavierbrea/eslint-plugin-boundaries | 997 | — | ~2.9k | Automated safety check: Pass | MIT |
Similar skills
Review Kedro PR
kedro-org/kedro
Review a Kedro PR for checklist compliance, architecture, correctness, and clarity.
Opik Documentation Patterns
comet-ml/opik
Rules for writing PR descriptions, changelog entries and feature documentation in the Opik repository, including the exact headings that CI requires.
Eli5
coldteadotai/pr-lens
WHAT: Explains a codebase, a folder, a feature, a command or a pull request to someone who knows nothing about it, as a PR Lens canvas whose walkthrough builds the picture one part at a time.
Review PR
javierbrea/eslint-plugin-boundaries
Review a GitHub pull request from three perspectives — functional fit against its linked issue, code correctness/quality, and architectural boundaries — then post a single GitHub review: one general…
Plain Writing
docwriter-org/plain-writing-skill
Writes and edits prose in a plain and boring style: simple everyday words, complete sentences, no dashes, no jargon, and no analogies.
More from pnp/copilot-pro-dev-samples
Copilot Studio Sample Review
pnp/copilot-pro-dev-samples
Review PRs for Microsoft Copilot Studio samples (mcs- folders) in pnp/copilot-pro-dev-samples.
Related
Works with
Categories
Questions about Declarative Agent Sample Review
What does Declarative Agent Sample Review do?
Review PRs for declarative agent samples (da- folders) in pnp/copilot-pro-dev-samples. Declarative Agent Sample Review is an agent skill from pnp/copilot-pro-dev-samples. Review PRs for declarative agent samples (da- folders) in pnp/copilot-pro-dev-samples.
When should I use Declarative Agent Sample Review?
Declarative Agent Sample Review fits situations like: reviewing da- sample submissions; checking manifest versions; validating README format; review this sample.
How do I install Declarative Agent Sample Review in Claude Code?
Run `npx skills add pnp/copilot-pro-dev-samples --skill declarative-agent-sample-review -a claude-code`. Or copy the skill folder (.github/skills/declarative-agent-sample-review in pnp/copilot-pro-dev-samples) into .claude/skills/declarative-agent-sample-review in your project. Claude Code loads it when a task matches its description.
How do I install Declarative Agent Sample Review in Codex?
Run `npx skills add pnp/copilot-pro-dev-samples --skill declarative-agent-sample-review -a codex`. Or copy the skill folder (.github/skills/declarative-agent-sample-review in pnp/copilot-pro-dev-samples) into .agents/skills/declarative-agent-sample-review in your project. Codex loads it when a task matches its description.
Can I use Declarative Agent Sample Review in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pnp/copilot-pro-dev-samples --skill declarative-agent-sample-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/declarative-agent-sample-review, .gemini/skills/declarative-agent-sample-review, .github/skills/declarative-agent-sample-review and .opencode/skills/declarative-agent-sample-review in your project.
What does Declarative Agent Sample Review need to run?
Going by SKILL.md and its folder, Declarative Agent Sample Review needs the command-line tools its instructions call (gh).
Does Declarative Agent Sample Review access the network?
SKILL.md names 1 domain. In commands or code: m365-visitor-stats.azurewebsites.net; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.
Is Declarative Agent Sample Review safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Declarative Agent Sample Review use?
Declarative Agent Sample Review is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Declarative Agent Sample Review use?
About 720 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Declarative Agent Sample Review?
Skills that share tags, products or a category with Declarative Agent Sample Review: Post Draft Review (agent-substrate/substrate, 4.5k stars), Review Kedro PR (kedro-org/kedro, 11k stars), Opik Documentation Patterns (comet-ml/opik, 22k stars) and Eli5 (coldteadotai/pr-lens, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Declarative Agent Sample Review?
pnp (a GitHub organization) maintains it in pnp/copilot-pro-dev-samples, which has 167 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 5, 2026.
Source: pnp/copilot-pro-dev-samples on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.