knowledge-harvest
Skill1 starsChanged 59 days agoMITView on GitHub
Build or refresh durable, source-backed project documentation on an explicit /harvest or /harvest-refresh request, including the first request in a new Cortex session.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- microsoft/cat-agent-skillstheir own version, first seen Nov 8, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- microsoft/cat-agent-skills★ 108same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository42 other files it gives its agents.
- AGENTS.mdAGENTS.md
- content-safetySkill
- context-compactionSkill
- coordinator-communicationSkill
- cortex-controlSkill
- design-frontend-designSkill
- design-impeccableSkill
- design-reference-analysisSkill
- design-ui-ux-pro-maxSkill
- design-visual-qaSkill
- design-workflowSkill
- documentation-syncSkill
- knowledge-harvest-scopeSkill
- orchestratorSkill
- requirements-intakeSkill
- skill-authoringSkill
- skill-managementSkill
- tool-disciplineSkill
- tool-discipline-workerSkill
- worker-accessibility-auditorSkill
- worker-accessibility-fixerSkill
- worker-architectSkill
- worker-backend-devSkill
- worker-build-verificationSkill
- worker-code-reviewerSkill
- worker-database-architectSkill
- worker-data-engineerSkill
- worker-debuggerSkill
- worker-devops-engineerSkill
- worker-explorerSkill
- worker-frontend-devSkill
- worker-fullstack-devSkill
- worker-generalSkill
- worker-mobile-devSkill
- worker-performance-engineerSkill
- worker-plannerSkill
- worker-qa-engineerSkill
- worker-refactorerSkill
- worker-security-auditorSkill
- worker-senior-consultantSkill
- worker-technical-writerSkill
- worker-ux-designerSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
18 rules. About 0 are common, 12 are distinctive, and 6 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈12
Distinctive · estimate
This author's own choices. Worth a look.
6
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 24
Read the target project's applicable docs/project/ and docs/features/ indexes and linked pages, then confirm claims in current source.
- Distinctive: line 36
Harvest refresh: Update existing project documentation by rebuilding the inventory from current source without trusting prior coverage …
- Very specific: line 50
After context loss, load skill context-compaction and follow its rereading procedure.
- Distinctive: line 57
Run safe examples and compare exact exit status and stdout with expectations.
- Very specific: line 78
Every completed harvest contains all five listed docs/project/ files.
- Distinctive: line 108
Ask only when missing information materially changes the outcome.
- Distinctive: line 120
If it is unavailable, denied, timed out, erroneous, unusable, or insufficient, record that concrete limitation and use exactly one bounded …
- Distinctive: line 127
Run the repository's deterministic knowledge-census validator when available.
- Very specific: line 132
Use <!-- GENERATED:START --> and <!-- GENERATED:END --> for refreshable facts.
- Distinctive: line 176
Use repository-native file enumeration as a completeness backstop.
- Distinctive: line 198
Do not create one page per generic helper, model, folder, or generated file.
- Distinctive: line 199
Do not collapse a large service into one shallow “service overview” page when it owns multiple workflows, state machines, commands, …
- Distinctive: line 218
Use these seven labels verbatim as the coverage table headers, in this order.
- Very specific: line 241
Every non-excluded row must link its Documentation cell to a canonical page below docs/features/.
- Distinctive: line 272
Look for a current coverage matrix with evidence and zero unexplained gaps.
- Distinctive: line 273
If absent, partial, stale, or contradicted, run a full baseline census.
- Very specific: line 274
If valid, detect source/config/test/deployment changes and their graph or caller impact, then update both affected pages and the global …
- Distinctive: line 314
only recent commits were scanned without a validated complete baseline.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Knowledge Harvest
Apply this skill only to an explicit harvest or harvest-refresh request. Bare
/harvest, including as the first prompt in a new project session, asks Cortex
to build durable documentation of the current project for future orchestration.
Optional command text narrows or clarifies its scope; it is not required to
start a task. /harvest-refresh asks Cortex to update an existing knowledge
base against current source. Neither route summarizes prior chat work or
requires a previous task. Ordinary product work does not implicitly authorize
a census or broad documentation rewrite.
Build a durable functional map of the repository, not a task journal or recent
commit summary. Documentation should let future Cortex tasks and a new engineer
discover each in-scope capability, its owning code, runtime behavior, and
verification or operating path. Publish it in the target project's canonical
docs/project/ and docs/features/ entry points below; these remain visible
across sessions through the project files, not through a prior task's chat.
Read the target project's applicable docs/project/ and docs/features/
indexes and linked pages, then confirm claims in current source. Missing or
unreadable indexes require a source-backed census. Stale or conflicting knowledge
does not by itself widen the assigned scope. Coordinator scope assessment lives
in knowledge-harvest-scope; workers own all harvest repository work.
Modes
- Harvest: Maintain a complete baseline. If no current source-backed coverage manifest establishes that the feature registry covers the repository, perform a full census. With a credible baseline, inspect changed and impacted surfaces and reconcile them against the complete inventory.
- Harvest refresh: Update existing project documentation by rebuilding the inventory from current source without trusting prior coverage claims. Audit existing project and feature documents against that inventory, correct stale facts, and reconcile coverage. Prior chat or report summaries are leads, not the refresh source. Finish with a source-backed post-write comparison. A correction to documented behavior, defaults, or output is a concrete correctness risk even when implementation source did not change. The runtime's mandatory review checks material claims; list them in your report.
Shared skills and reporting
Apply skill tool-discipline to calls. Draft creator guidance and the worker
profile supply the report requirements. Load a declared report example (index)
only for an assigned content question.
After context loss, load skill context-compaction and follow its rereading procedure.
Post-write evidence
Compare the source inventory with the coverage matrix, pages, links and checks. For corrected behavior, defaults or outputs, inspect all relevant documentation occurrences and executable examples, including otherwise unchanged pages. Run safe examples and compare exact exit status and stdout with expectations; retain unsafe or unverifiable examples as unresolved with concrete reasons. Report material corrected claims for the runtime's independent source-backed review. A harvest is documentation-impacting; never claim documentation not required. Preserve unaffected pages instead of making token edits.
Output structure
Maintain these canonical documents:
docs/project/index.md
docs/project/conventions.md
docs/project/verification.md
docs/project/decisions.md
docs/project/gotchas.md
docs/features/index.md
docs/features/<feature>/index.md
docs/features/<feature>/<focused-detail>.mdEvery completed harvest contains all five listed docs/project/ files. The
project index links the other four. Every non-excluded coverage row links a
canonical docs/features/<feature>/index.md entry point; a flat
docs/features/<feature>.md page alone is not canonical.
docs/features/index.md is the coverage manifest. It records census scope,
source categories, discovered features and pages, unmapped surfaces,
exclusions, known unknowns, and coverage status. “Complete” means every
in-scope feature-bearing surface is mapped or explicitly excluded with
evidence, not a guessed percentage of files.
Feature pages are behavior-complete rather than token summaries. Split a large
feature into focused workflow, state/data, interface, configuration, operation,
or verification pages while keeping index.md as its canonical entry point.
Delegation reports
Each worker receives its concrete assignment and mandatory requirements directly. It reads the reports its assignment names, lists the catalogue only when a needed reference is missing, and reads only needed pages before acting. It publishes its Markdown report through the same writer as every other profile, opening with the decision brief the publication tools require. The report states completed work and every incomplete or failed check truthfully. The live advertised contract alone defines tool arguments.
Report IDs are durable evidence references, not proof that work is complete. A successor reads only the reports it needs. A partial or failed report can support replacement, narrower research, parallel progress elsewhere, or an honest residual-risk statement.
Ask only when missing information materially changes the outcome. Coordinators use their advertised user-question route; workers use their advertised question route directly to the user. Internal storage and worker coordination conditions alone are not user questions. Follow the live schema, group related questions, and make meaningful alternatives and their consequences clear.
Evidence and preservation
Source, tests, executable configuration, schemas and migrations, and deployment definitions outrank generated documentation. Codebase Memory is the preferred worker route for structural project-code discovery when available: bind it to the exact canonical project root and use its graph evidence before local search. If it is unavailable, denied, timed out, erroneous, unusable, or insufficient, record that concrete limitation and use exactly one bounded repository-native enumeration or file/text-search fallback. Check index coverage for every cited graph path and bounded scope; confirm consequential claims in current source. A fallback must remain limited to the requested scope; never silently fall back or chain multiple fallback searches.
Run the repository's deterministic knowledge-census validator when available. Its result is advisory evidence for the model's own readiness judgment and the runtime's independent review, never a backend gate, authorization decision, or substitute for source confirmation.
Use <!-- GENERATED:START --> and <!-- GENERATED:END --> for refreshable
facts. Preserve text outside generated blocks and do not overwrite manual
decisions, gotchas, or feature explanations without evidence and explicit
scope. Never expose secrets, source dumps, private operational values, or
personal data.
Incomplete reports or unresolved dependencies may affect the model's readiness recommendation, but never prevent useful delegation, evidence access, corrective work, or a truthful final answer.
Feature census and completeness contract
Contents
- Inventory surface
- Feature boundary rules
- Coverage matrix
- Required feature documentation
- Mode-specific validation
- Failure conditions
Inventory surface
Build the inventory independently of existing docs. Inspect every applicable category, recording counts and representative authoritative paths:
- deployable applications and services;
- packages, bounded domains, and shared runtime libraries;
- API routes, controllers, handlers, RPC/GraphQL endpoints, and public SDKs;
- user-facing screens, navigation flows, commands, and administrative tools;
- background workers, schedulers, queues, consumers, pollers, reconcilers, and maintenance jobs;
- domain policies, use cases, state machines, orchestration flows, and feature flags;
- database schemas, migrations, repositories, caches, files, and external state stores;
- third-party adapters, webhooks, exchanges, payment/auth/model providers, and other integration boundaries;
- configuration groups, environment-controlled behavior, safety limits, and compatibility switches;
- deployment manifests, process definitions, health checks, bootstrap paths, observability, and operational recovery;
- tests and fixtures that reveal supported behavior, invariants, negative paths, or hidden feature ownership.
Use repository-native file enumeration as a completeness backstop. Codebase Memory is the preferred worker route for project-code discovery when available: bind it to the exact canonical project root and use graph search, path tracing, then exact snippets before local search. If it is unavailable, denied, timed out, erroneous, unusable, or insufficient, record that concrete limitation and use exactly one bounded file/text-search fallback. Check graph coverage for every cited graph path and bounded scope, then confirm consequential claims in current source. Do not silently fall back or chain additional local searches. Graph evidence helps explain relationships but never replaces source-tree enumeration. Generated, vendored, build, cache, and dependency directories may be excluded once with a recorded reason. Tests are evidence and coverage signals, not separate product features unless the repository ships a testing product or framework.
Feature boundary rules
A feature is a cohesive capability with recognizable developer, operator, or user behavior and an owning runtime path. Prefer stable behavioral boundaries over directory names. A feature may cross packages or services. Shared infrastructure may have its own page when it exposes consequential contracts, failure behavior, or operational ownership.
Do not create one page per generic helper, model, folder, or generated file. Do not collapse a large service into one shallow “service overview” page when it owns multiple workflows, state machines, commands, integrations, or safety contracts. Split it into discoverable feature pages and link shared flows.
Coverage matrix
The feature index must contain a source-backed matrix.
It must use these five literal Markdown section headings; prose mentions do not substitute for them:
## Coverage matrix
## Inventory totals
## Unmapped surfaces
## Exclusions
## Known unknownsUse these seven labels verbatim as the coverage table headers, in this order; additional columns may follow:
| Feature | Runtime owner | Entry points | Source evidence | Documentation | Verification | Status || Field | Required meaning |
| Feature | Stable human-readable capability name |
| Runtime owner | Application/service/package/process that executes it |
| Entry points | Routes, commands, jobs, screens, events, or symbols |
| Source evidence | Key project-relative paths |
| Documentation | Canonical feature page(s) |
| Verification | Relevant tests or safe checks |
| Status | covered, documented, verified, or excluded in a final accepted manifest; partial or unknown remains in progress and prevents a complete-coverage claim |
Also record totals for inventoried feature-bearing surfaces, mapped surfaces, documented features, partial/unknown items, unmapped items, and exclusions. Coverage acceptance requires zero unexplained unmapped surfaces. Partial or unknown items remain visible and prevent a claim of complete behavioral coverage unless their boundary is explicitly out of scope.
Every non-excluded row must link its Documentation cell to a canonical page
below docs/features/. Every row must contain all seven required cells; prose
elsewhere in the file does not substitute for a missing header or cell.
Required feature documentation
Each feature entry point must lead to documentation covering all applicable sections:
- purpose, actors, and externally observable behavior;
- runtime owner, entry points, and key source map;
- main workflows and alternate/negative paths;
- state model, lifecycle, invariants, and concurrency/idempotency rules;
- data ownership, persistence, schemas, cache behavior, and consistency;
- APIs, events, commands, UI interactions, and integration contracts;
- configuration, feature flags, defaults, limits, and precedence;
- authorization, trust boundaries, sensitive-data handling, and safety rules;
- failure modes, retries, fallback, recovery, rollback, and degradation;
- observability, health, logs/metrics, deployment, and operational gotchas;
- verification commands, tests, fixtures, and evidence limitations;
- related features, decisions, known gaps, and unresolved questions.
Omit an inapplicable section only with a short reason. Avoid placeholder text, generic prose that could describe another project, and unsupported production claims. Cite paths and symbols densely enough that a maintainer can verify the page without repeating repository-wide discovery.
Mode-specific validation
Harvest
- Look for a current coverage matrix with evidence and zero unexplained gaps.
- If absent, partial, stale, or contradicted, run a full baseline census.
- If valid, detect source/config/test/deployment changes and their graph or caller impact, then update both affected pages and the global matrix.
- Sample unchanged domains and reconcile top-level process/package inventory so an incremental run cannot preserve a silently incomplete baseline.
Harvest refresh
- Rebuild the complete inventory without trusting current feature pages.
- Map the fresh inventory to the existing registry and audit every project and feature page against current source. Correct stale facts, links and coverage; preserve supported manual content. Do not substitute chat or report summaries.
- Rewrite generated sections and add/split pages until the matrix has no unexplained gaps.
- Compare the post-write pages and manifest with the fresh source inventory, including every relevant occurrence across the target repository's documentation and otherwise unchanged pages whenever a documented behavior, default or output is corrected, even if source is unchanged. Inventory all affected executable examples, compare safe executions' exact exit status and stdout with the documented results, and retain unexecutable examples as unresolved. Run relevant deterministic documentation checks. The writer can do this; the runtime's mandatory review checks material claims against current source and post-write docs. List corrected claims and example results in your report. Propose additional investigation only for a concrete unresolved uncertainty.
- Finish when the comparison finds no further factual change or feature page to add; record any check that could not run and any unresolved gap.
Failure conditions
The completeness contract fails when required inventory, coverage, or documentation evidence is missing, contradictory, or silently excluded. The repository's deterministic census validator may report these conditions as advisory verification evidence; it never authorizes work, blocks backend tools, or replaces independent source confirmation and the model's readiness judgment.
Corrective findings
Record a finding in your report as unresolved, for the coordinator to decide, instead of claiming completion when:
- only recent commits were scanned without a validated complete baseline;
- a large repository received one broad explorer with no domain partitioning;
- the feature registry maps only top-level services while omitting their distinct workflows and capabilities;
- inventory or coverage counts are absent;
- any in-scope surface is unmapped, silently dropped, or marked with a vague exclusion;
- feature pages omit consequential behavior, state, configuration, failure, integration, operations, or verification details;
- documentation claims were copied from delegation reports without source/test checks;
- refresh lacks a source-backed post-write comparison, leaves stale facts in existing pages or examples, or claims completion despite an unexplained gap;
- documented behavior, defaults or output were corrected without a targeted search of existing examples, safe example-result comparison, and material claims listed for the runtime's mandatory source-backed review.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

