agentleFS
r-jellyr-jelly/chronicle/skills/audit-career-evidence/SKILL.md

audit-career-evidence

Skill0 starsChanged 4 months agoMITView on GitHub

Audit Chronicle project, STAR, and resume claims for evidence quality, ownership, consistency, stale assertions, sensitive information, and unsupported metrics. Use when preparing to write or publish career materials, reviewing captured project records, checking a potentially exaggerated claim, or deciding what evidence must be recovered.

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 3 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Never upgrade a claim because it sounds plausible.

    line 48
  2. Distinctive:

    Do not call the audit complete if files or referenced sessions could not be read.

    line 75
  3. Distinctive:

    If the user asks to apply findings, make targeted edits:

    line 80
  4. Very specific:

    add user-confirmed:<date> only after explicit confirmation.

    line 85
  5. Very specific:

    keep the project or session captured until critical review is complete.

    line 86

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Audit Career Evidence

Assess whether a project story can be defended in a resume or interview. Default to a read-only report; edit Chronicle files only when the user asks to apply the audit.

Scope

Resolve the requested project under <vault>/chronicle/projects/<project-id>/. Read PROJECT.md, TIMELINE.md, OWNERSHIP.md, DECISIONS.md, EVIDENCE.md, STAR.md, and their referenced session records when present.

Let <plugin-root> be ${CLAUDE_PLUGIN_ROOT} when Claude Code supplies it; otherwise use the directory two levels above this SKILL.md. Read <plugin-root>/docs/DATA_MODEL.ko.md when a label or evidence rule is unclear.

Audit Each Claim

Classify every career-relevant claim:

  • confirmed: direct evidence supports both the action and the attributed ownership or result;
  • inferred: context supports the claim, but a key link is indirect;
  • needs-evidence: a metric, outcome, ownership statement, or causal claim lacks defensible support.

Check:

  1. Evidence reference exists and points to the claimed fact.
  2. Result claims distinguish observed change from assumed causation.
  3. Metrics include unit, baseline, comparison, population, and measurement method when those details matter.
  4. Personal ownership is distinct from team output.
  5. Decision claims include the actual constraints, alternatives, and trade-offs.
  6. Project files and session records do not contradict each other.
  7. The claim is still current or clearly dated.
  8. Public wording does not expose secrets, customer data, internal URLs, unreleased plans, or confidential scale figures.
  9. Resume language does not strengthen the source claim through words such as “led,” “designed,” “owned,” “eliminated,” or “improved” without support.

Never upgrade a claim because it sounds plausible. Never invent a replacement number.

Produce the Report

Group findings by severity:

  • Blocker: unsafe to publish or materially misleading;
  • Needs review: important ambiguity in ownership, result, or consistency;
  • Evidence opportunity: useful evidence could be recovered;
  • Ready: sufficiently supported for the intended use.

For each non-ready claim, provide:

  • the exact claim or a short identifying excerpt;
  • current and recommended state;
  • the gap;
  • the smallest useful next action;
  • likely evidence sources, without claiming they exist.

End with a compact readiness summary:

confirmed N / reviewed M / audited T
blockers B / needs review R / evidence opportunities E

Do not call the audit complete if files or referenced sessions could not be read.

Apply Only on Request

If the user asks to apply findings, make targeted edits:

  • preserve original wording when adding a state label is enough;
  • append missing-evidence tasks to EVIDENCE.md;
  • record conflicts rather than deleting one side;
  • add user-confirmed:<date> only after explicit confirmation;
  • keep the project or session captured until critical review is complete.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.