How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/mikubaka88/ccfa-skills --skill ccf-literature-searcherBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
CCF Literature Searcher
Preflight And Scope
Apply ccf-humanization first, then ccf-common; reuse active applicable rules. Handoff mode remains PARTIAL under metadata and Common's handoff rules. This owner finds literature, prior art, datasets, benchmarks, citation candidates and opportunity maps. Recent-paper/competitor watch belongs to ccf-literature-monitor; judgment, drafting and existing-citation audits retain their respective owners.
Before browsing, apply privacy-and-evidence.md. Convert private research into public-safe terms rather than copying draft sentences or unpublished results into queries. Preserve no-browsing and supplied-evidence-only limits. Apply shared source exclusions, including default MDPI exclusion; a named user-directed source is a scoped exception, not permission for unrelated recommendations. Keep routine screening internal.
Use Common's task modes: exploratory for direction/opportunity scouting, quick for a small lookup, standard for substantial related-work/novelty/benchmark retrieval. A helper's scope does not become a full standalone search merely because another skill will use it. The user's requested breadth wins; planning ranges are not quotas.
Retrieve And Verify
Read search-and-scoring.md for source roles, query/reuse strategy, taxonomy, relevant scoring anchors and standalone search guidance. Ground substantive claims in inspected original papers or primary artifacts. Indexes and stable landing pages establish identity; snippets, citation counts, institutional prestige and awards do not establish scientific findings. Include relevant technical reports, conference/journal papers and arXiv originals according to their content, version and status.
- Identify the actual search question and use public-safe query clusters. Batch independent discovery and metadata lookups; request only needed fields. Resolve ambiguous identities and deduplicate by stable identifier plus normalized title before deeper reading; retain distinct versions and supplements.
- Verify decisive method/result/overlap claims in original passages, inspecting uncertain PDF pages when necessary. Reuse current source caches and locations; an unchanged PDF does not prove that no newer version exists. Record source/version, inspected coverage, type, relevance and stable link. Inaccessible sources can remain explicit retrieval leads, not scored findings or evidence of absence.
- Compare what closest work already establishes and the meaningful remaining difference. Keep closest comparators, mechanism-bearing inspirations and counterexamples distinct. An unsearched/crowded topic is uncertain, not automatically dead; a weak result does not erase prior existence. Do not invent a rescue module or abandon the broader user goal when one candidate is covered.
- Score only when requested or useful and supported by inspected text. Keep insight/completeness/numerical support separate from relevance and novelty overlap; use contribution-appropriate
N/Aandnot assessedinstead of penalizing unavailable or inapplicable experiments. Benchmark papers use the reference's benchmark-quality note. No acceptance probabilities. - Stop when the requested questions/clusters are covered and further retrieval adds no material information; broaden for a specific remaining gap. Reuse verified work rather than searching per paragraph or filling a paper quota. Return source passages and locations separately from model interpretation.
Deliver And Hand Off
Return the user's requested list, clusters, opportunity map, BibTeX candidates, benchmark table or compact handoff first. Include material coverage limits where they change the conclusion, without empty score/status sections. For idea development, pass source-backed observations, mechanism primitives, assumptions, relevant relations and protocol anchors; older or analogous-field work can be useful beyond recent nearest neighbors. For writing/review, pass the exact support or overlap needed and its source location, not repeated full abstracts. search-and-scoring.md provides the detailed handoff guidance.
Create files only for requested/necessary reusable output under artifact-contracts.md; preserve inputs, UTF-8/Chinese text and the established folder. Otherwise a helper returns evidence in context without a report. Use report-template.md for a new default ccfa-workfiles/literature/<topic-slug>/: current papers.md, optional structured papers.csv, separate notes only when needed, and idea-grounding.md when useful. Derive views from one screened source set, update in place, and keep dates/versions inside rather than generating iteration folders. Required prerequisite work continues through its owner under existing authorization.

