code-prior-art-survey

Surveys open-source prior art for a software idea across code hosts, registries, and communities.

1|1|Updated May 24, 2026
One-click install
npx skills add https://github.com/bm629/agent-skills --skill code-prior-art-survey-bm629
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-prior-art-survey
Source: https://github.com/bm629/agent-skills/tree/main/skills/code-prior-art-survey
Command: npx skills add https://github.com/bm629/agent-skills --skill code-prior-art-survey-bm629

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, jsonschema, and includes scripts (resource) and references (resource) components.

What problem does it solve? Before designing a software system, teams often rebuild what already exists because they never systematically searched the open-source world. This Skill runs a reproducible prior-art survey — deriving a typed keyword map, executing search angles across dozens of sources, deep-reading candidate repositories, and synthesizing findings — so design decisions rest on evidence rather than guesswork. ## Core Features & Use Cases - Keyword-map derivation: Distills a scope description into typed search vocabulary (domain, capability, technique, ecosystem anchor, community, competitor groups) with provenance-stamped expansions, negative terms, and a community-vocabulary probe. - Nine search angles: Executes one discovery mechanism per run — host metadata search, curated catalogs, package registries and dependents graphs, code-content search, alternative directories, community mining, academic code, model hubs, and platform marketplaces — with machine-checkable coverage cells proving every group-by-source pair was worked. - Extraction and synthesis: Deep-reads one candidate repo into a 10-section extraction with verdict, 0-10 score, SPDX license, and purl dependencies, then aggregates the extract set into an eleven-section report plus a machine-readable borrow-index. - Schema-validated outputs: Every artifact (keyword map, search output, extraction, borrow-index) is gated by JSON Schemas and a deterministic validator script that must exit 0 before handoff. - Use Case: Before building a backtesting engine, run the survey to derive the keyword map, execute the registry and community angles, extract the top five candidate repos, and produce a borrow-vs-build report showing which subsystems have production-grade prior art. ## Quick Start Ask the agent to run a code prior art survey for your software idea, starting with deriving the keyword map from your scope description.

Frequently Asked Questions about code-prior-art-survey

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find open-source prior art before building a software system?

Start by deriving a keyword map from your scope description, then execute search angles across code hosts, package registries, curated catalogs, and community channels. Each candidate repository is deep-read into a structured extraction with a verdict and quality score, and the set is synthesized into a borrow-vs-build report.

What sources does an open-source repository discovery survey cover?

The survey covers nine angles: host metadata search (GitHub, GitLab, Codeberg, and others), curated awesome and best-of lists, package registries with dependents graphs, public code search engines, alternative directories, community channels like Reddit and Hacker News, academic code, model hubs, and platform marketplaces.

How is search coverage proven in a prior art survey?

Every keyword-group-by-source pair produces a coverage cell recording the exact queries run, a timestamp, and the result count. Zero-hit cells are mandatory evidence of work, and unreachable sources are recorded as typed cells with a cause rather than silent omissions.

Does this skill handle patent or legal prior art searches?

No. The survey covers code and open-source implementation research only. Patent and legal prior art searches are explicitly out of scope and require different tooling and expertise.

Why does the prior art validator fail with an ImportError?

The validator script requires the pyyaml and jsonschema Python packages on the invoking interpreter. An ImportError indicates a missing environment dependency, not a defect in the artifact being validated.

Can I update an existing survey when my project scope grows?

Yes. A delta-mode keyword map names its baseline via lineage and lists inherited groups that are not re-searched, covering only net-new capabilities. The synthesis run then amends the existing report and appends a dated changelog entry.