Skip to content

Slim SKILL.md core and add cross-platform resume reference#30

Merged
hacktivist123 merged 2 commits into
hacktivist123:mainfrom
uncoooloj:docs/skill-core-slim-cross-platform
Jun 20, 2026
Merged

Slim SKILL.md core and add cross-platform resume reference#30
hacktivist123 merged 2 commits into
hacktivist123:mainfrom
uncoooloj:docs/skill-core-slim-cross-platform

Conversation

@uncoooloj

Copy link
Copy Markdown
Contributor

Depends on #28 (canonical packaged path for skill-provenance.py).

SKILL.md is loaded on every trigger and had grown to 11.4KB (~2.8k tokens), restating the same evidence discipline three times. This trims it to 6.6KB (-42%) without dropping behavior:

  • Detailed provenance bookkeeping, long-tail Evidence Rules, and the Static Idempotency Contract move to a new references/evidence-and-provenance.md, loaded only when needed.
  • New step 1: cheap provenance self-check (skill-provenance.py or manual path/size compare) so stale installs surface in the resume report — in practice three different skill versions were live across repo/Claude/Codex installs and nobody noticed.
  • New references/cross-platform.md: workflow for asks that span platforms ('review my threads across Claude and Codex') — per-adapter discovery, UTC normalization, merged timeline keyed by cwd + time window, per-runtime evidence attribution, overlap dedupe.
  • Frontmatter description broadened to also trigger on locating/reading/auditing/reviewing prior sessions, not just continuing them — observed misses where 'find/audit my session' asks never fired the skill.

validate-skill-package, validate-trigger-matrix, validate-fixtures all pass.

🤖 Generated with Claude Code

uncoooloj and others added 2 commits June 20, 2026 00:01
SKILL.md drops from 11391 to 6558 bytes (-42%) by merging the
triplicated evidence prose into Core Workflow and moving the detailed
provenance bookkeeping, long-tail evidence rules, and the static
idempotency contract into references/evidence-and-provenance.md,
leaving one-line pointers in the core file.

Also broadens the frontmatter description to trigger on locating,
reading, inspecting, auditing, or reviewing prior sessions and on
cross-agent asks; adds a provenance self-check step (canonical path
skills/agent-session-resume/scripts/skill-provenance.py); and adds
references/cross-platform.md with a workflow for multi-runtime
resume/audit asks (independent per-adapter discovery, UTC-epoch
normalization, merged timeline, per-runtime evidence attribution,
overlap dedupe, single task-status breakdown).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…rd trigger description regressions

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@hacktivist123 hacktivist123 force-pushed the docs/skill-core-slim-cross-platform branch from 33a542c to bad4e9f Compare June 20, 2026 00:02
@hacktivist123 hacktivist123 merged commit 89082dd into hacktivist123:main Jun 20, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants