RESEARCH AND EVIDENCE / GitHub community
Build Evidence Map
Builds a structured map of claims, evidence and unresolved gaps, with a local validator for the map’s structure.
“Build an auditable evidence map for a contested technical choice, research synthesis, proposal review, or consequential decision. Use when Copilot must preserve …”
01 / THE REASONING
Why this made the selection.
- Preserves supporting, contradicting, qualifying and missing evidence as separate relationships instead of flattening a contested choice into confident prose.
- Requires identifiable source regions and gives the map a structural validator and reproducible receipt hashes.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- skills/build-evidence-map/SKILL.md
- README.md (installation and supported-host sections)
- LICENSE
- skills/build-evidence-map/references/evidence-ladder.md
- skills/build-evidence-map/references/map-schema.md
- skills/build-evidence-map/scripts/contract.mjs
- skills/build-evidence-map/scripts/validate.mjs
- Skill directory (all five files) and LICENSE compared with the previous review revision a19b3101: byte-identical at 156736fb (git blob SHAs). The README change between them is contributor credits only.
- vercel-labs/skills@13e4063a1cf913f5606d57d42ab83a86f5001e04:README.md
Our findings
- The entire skill, schema/evidence references and both JavaScript helpers were read.
- The validator checks dates, IDs, edge targets, graph reachability and cycles, then hashes canonicalized content; no helper was executed.
- Typed edges carry explanations, topical similarity is insufficient support, and differences in scope, date, or population are not automatically contradictions; unresolved facts become explicit unknown nodes.
Not established by this review
- No upstream definition, helper, installer or generated workload was executed.
- No end-to-end agent session or effectiveness benchmark was run.
- Not executed: it was not installed or run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
DOCUMENTED COMMAND
npx skills add github/awesome-copilot/skills/build-evidence-map --skill build-evidence-map Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.
Optional: install the reviewed revision
Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.
npx skills add https://github.com/github/awesome-copilot/tree/156736fb63e965b2f547a1460f3b5972c46e6b24/skills/build-evidence-map --skill build-evidence-map - Install the complete skill directory, including its references and helpers; select your AI tools and project or global scope.
- Review the instructions before invoking them. The source revision shown here is the one reviewed; the installer was not executed or version-pinned by this review.
Before you start
- Node.js/npm and git for the documented Skills installer
- An agent host that supports the skill format and the tools required by the workflow
- Node.js for the bundled structural validator; optional Doubt CLI is a separate dependency
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/github/awesome-copilot/blob/156736fb63e965b2f547a1460f3b5972c46e6b24/skills/build-evidence-map/SKILL.md
Supports: summary, upstreamDescription, whySelected, bestFor, limitations, review, access
https://github.com/github/awesome-copilot/blob/156736fb63e965b2f547a1460f3b5972c46e6b24/README.md
Supports: install, compatibility
https://github.com/github/awesome-copilot/blob/156736fb63e965b2f547a1460f3b5972c46e6b24/LICENSE
Supports: license, access.cost
https://github.com/github/awesome-copilot/blob/156736fb63e965b2f547a1460f3b5972c46e6b24/skills/build-evidence-map/references/evidence-ladder.md
Supports: review, limitations, install, access
https://github.com/github/awesome-copilot/blob/156736fb63e965b2f547a1460f3b5972c46e6b24/skills/build-evidence-map/references/map-schema.md
Supports: review, limitations, install, access
https://github.com/github/awesome-copilot/blob/156736fb63e965b2f547a1460f3b5972c46e6b24/skills/build-evidence-map/scripts/contract.mjs
Supports: review, limitations, install, access
https://github.com/github/awesome-copilot/blob/156736fb63e965b2f547a1460f3b5972c46e6b24/skills/build-evidence-map/scripts/validate.mjs
Supports: review, limitations, install, access
https://github.com/vercel-labs/skills/blob/13e4063a1cf913f5606d57d42ab83a86f5001e04/README.md
Supports: install
https://github.com/vercel-labs/skills/blob/13e4063a1cf913f5606d57d42ab83a86f5001e04/src/git.ts
Supports: install
https://github.com/vercel-labs/skills/blob/13e4063a1cf913f5606d57d42ab83a86f5001e04/src/source-parser.ts
Supports: install
https://raw.githubusercontent.com/github/awesome-copilot/156736fb63e965b2f547a1460f3b5972c46e6b24/skills/build-evidence-map/SKILL.md
Supports: review.findings, bestFor, upstreamDescription