capture-collaboration-evidence
Skill2 starsChanged 4 months agoMITView on GitHub
Continuously notice, evaluate, and preserve defensible examples where a human and an AI agent materially improve one another's reasoning and produce a design, diagnosis, test, implementation, or decision stronger than either starting approach. Use implicitly during substantive human-agent collaboration—especially when the human challenges an agent assumption, the agent stress-tests or refines a human proposal, both revise their models, a local issue becomes a reusable abstraction, or a milestone adds proof—even if the human did not ask to document it. Also use when reviewing, appending, or upgrading the global "Evidence of agent-human collaboration superior to either alone" ledger.
In this repository27 other files it gives its agents.
- clarify-before-buildingSkill
- cross-platform-project-build-archSkill
- deep-code-reviewSkill
- dispatchSkill
- erect-agent-stackSkill
- fix-zig-deps-hashSkill
- gather-project-intentionsSkill
- handoffSkill
- i18nSkill
- lean4-developmentSkill
- llvm-guided-optimizationSkill
- mechatron-ciSkill
- memoriesSkill
- mficSkill
- no-ai-slopSkill
- onboardSkill
- performance-profilingSkill
- planning-workSkill
- scaffold-zig-projectSkill
- shipSkill
- test-isolationSkill
- universal-app-frontendSkill
- walking-decisionsSkill
- writing-bendSkill
- writing-nixSkill
- writing-rocSkill
- zig-microbenchmarksSkill
The file
We split this skill into the rules it gives an agent
7 rules. About 0 are common, 7 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈7
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 8
Keep watch for exceptional interaction effects, not merely good work by one participant.
- Distinctive: line 13
Do not turn the collaboration into constant self-observation.
- Distinctive: line 53
Verify the case against the admission test using the actual exchange and artifacts.
- Distinctive: line 65
If a recorded design later becomes tested, shipped, live-validated, or disproved, append the new evidence without erasing the earlier stage.
- Distinctive: line 68
Run the memories frontmatter validator over the affected shared root.
- Distinctive: line 80
Use factual, skeptical language suitable for an interviewer, manager, researcher, or critic.
- Distinctive: line 94
If the case cannot survive the admission test, leave the ledger alone.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 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
Capture collaboration evidence
Keep watch for exceptional interaction effects, not merely good work by one participant. Peter has asked agents to capture qualifying cases proactively because the human participant may be focused on the work and not notice the evidence as it forms.
Do not turn the collaboration into constant self-observation. Check quietly after a substantive reasoning turn, a changed decision, a test result, or a milestone. Continue the primary task and write at the next natural quiet point unless evidence is at immediate risk of being lost.
Admission test
Record a case only when every answer is yes:
- Distinct human contribution: Did the human contribute a non-generic observation, constraint, model, challenge, or creative connection?
- Distinct agent contribution: Did the agent contribute analysis, formalization, experimentation, edge cases, implementation, or correction beyond restating or executing the human's contribution?
- Causal synthesis: Did the exchange change at least one participant's model or produce a result neither starting position already contained?
- Credible counterfactual: Can a skeptical reader identify what the human alone and the agent alone, from their actual starting positions, each plausibly would have missed?
- Traceable evidence: Is there a conversation, message, plan, test, diff, commit, log, screenshot, live observation, or other durable artifact? A concrete design may be recorded before implementation only when its stage and pending proof are explicit.
Reject mere agreement, praise, rapport, speed, output volume, a human correcting an agent without a reciprocal agent contribution, an agent completing a specification without changing it, or a hypothetical benefit presented as an outcome. Do not treat one case as proof that all human-agent collaboration is superior.
Capture workflow
- State briefly in commentary that the interaction appears to meet the evidence threshold and that this skill is capturing it. Do not ask for confirmation unless the contribution, scope, or evidence is genuinely ambiguous.
- Invoke the
memoriesskill before reading or writing memory files. Use its metadata-only title listing to find the private shared ledger namedEvidence of agent-human collaboration superior to either alone; load only that body and directly relevant evidence. - Verify the case against the admission test using the actual exchange and artifacts. Preserve disagreement and uncertainty. Never invent an exact timestamp, causal claim, empirical result, or quotation.
- Append a concise ledger row and a detailed case containing:
- time, project/context, and evidence stage;
- the human's distinct contribution;
- the agent's distinct contribution;
- the interaction effect;
- separate human-alone and agent-alone counterfactuals;
- durable evidence pointers;
- material outcome and professional relevance;
- pending proof or possible disconfirmation.
- If a recorded design later becomes tested, shipped, live-validated, or disproved, append the new evidence without erasing the earlier stage. The evolution is itself useful evidence.
- Run the memories frontmatter validator over the affected shared root. Report the capture in the task's final summary without making it the center of the work.
Peter's proactive authorization is limited to this private global ledger. Do not write another project, publish an entry, contact a third party, or expose private context under this skill. Include only personal detail necessary to understand the professional case; omit health, family, credentials, and unrelated private information.
Writing standard
Use factual, skeptical language suitable for an interviewer, manager, researcher, or critic. Prefer “the exchange produced X, evidenced by Y” over claims about intelligence or personality. Name the agent's abandoned starting position when known; revision under challenge is evidence, not embarrassment.
Good evidence shows reciprocal leverage:
human observation or model
→ agent stress test, experiment, or formalization
→ human refinement or cross-domain constraint
→ stronger testable resultIf the case cannot survive the admission test, leave the ledger alone.
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.

