Skip to content

Consolidate vault skills#4

Merged
markphelps merged 2 commits intomainfrom
consolidate-vault-skills
Apr 18, 2026
Merged

Consolidate vault skills#4
markphelps merged 2 commits intomainfrom
consolidate-vault-skills

Conversation

@markphelps
Copy link
Copy Markdown
Owner

This pull request makes significant improvements and clarifications to the documentation for several vault management skills. The main changes include removing outdated or redundant skill descriptions, adding a new skill for concept management, updating the concept promotion workflow, and introducing a comprehensive new ingestion pipeline skill. These updates help clarify responsibilities and workflows for each skill, reduce duplication, and improve thematic organization.

Major additions and new skills:

  • Added a new vault-concepts skill, which is responsible for maintaining canonical concept pages and surfacing recurring themes across the vault. This skill defines clear thresholds for concept creation, a detailed workflow, and confidence rubrics. (skills/vault-concepts/SKILL.md)
  • Introduced a new vault-ingest skill, which describes an end-to-end ingestion pipeline for processing captured sources, promoting themes to concepts, updating navigation, archiving sources, and auditing processed archives. (skills/vault-ingest/SKILL.md)

Refinements and removals for existing skills:

  • Removed the skill description frontmatter and detailed documentation for the following skills, likely to reduce duplication and move their responsibilities under new or revised skills:
    • vault-archive-audit
    • vault-challenge
    • vault-cleanup
    • vault-compact
    • vault-connect
    • vault-drift
    • vault-ideas
    • vault-index

Improvements to concept promotion and navigation:

  • Updated the vault-concept-promoter skill to reference the new vault-concepts and vault-maintain skills for canonical workflows and maintenance, replacing older references. It also clarifies that updating navigation and logs should be done manually if the vault maintains these files, and updates output to reflect this. (skills/vault-concept-promoter/SKILL.md) [1] [2] [3]

Thematic organization and clarity:

  • The changes overall improve the separation of concerns between skills (e.g., concept management, ingestion, navigation), clarify safety and output contracts, and provide more actionable workflows and confidence rubrics.

These updates should make the vault management skills easier to understand, maintain, and extend.

Core skills:
- vault-ingest: merges vault-process + vault-cleanup
- vault-lint: tightened scope on notes/ and projects/
- vault-tracker: merges vault-project-tracker + vault-archive-audit + vault-organize
- vault-maintain: merges vault-weekly-maintainer + vault-index + vault-log + vault-qmd

Optional skills:
- vault-concepts: renamed from vault-concept-promoter, merges vault-drift
- vault-research: unchanged

Deprecated 15 skills (marked with migration notice):
vault-archive-audit, vault-challenge, vault-cleanup, vault-compact,
vault-concept-promoter, vault-connect, vault-drift, vault-ideas,
vault-index, vault-log, vault-organize, vault-process,
vault-project-tracker, vault-qmd, vault-session-sync, vault-weekly-maintainer

Updates vault/AGENTS.md with new architecture documentation.
Signed-off-by: Mark Phelps <209477+markphelps@users.noreply.github.com>
@markphelps markphelps merged commit 4f4585b into main Apr 18, 2026
1 check passed
@markphelps markphelps deleted the consolidate-vault-skills branch April 18, 2026 12:21
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.

1 participant