Maintenance

Personal API should stay small, verifiable, and aligned across source files, setup output, and release packages.

Monthly Vault Health Check

Ask an AI assistant:

Run a vault health check.

It should check:

• stale items in 30.knowledge/10.capture/inbox/;
• outdated project status in 00.context/;
• orphan notes without links;
• important files with stale updated: frontmatter;
• missing MOC links for topics that have grown.

Skill Release Check

Before publishing a new skill package, run:

bash -n scripts/setup.sh
python scripts/validate_skill.py
bash scripts/package_skillhub.sh
python scripts/validate_skill.py --dist dist/skillhub/personal-api-2.0.3-skillhub.zip

The release is not ready if:

• source version, README badge, changelog, and zip filename disagree;
• full setup does not create 30.knowledge/;
• minimal setup creates 30.knowledge/;
• a documented required path is not generated by setup;
• the zip package omits required skill assets.

Change Discipline

• Keep SKILL.md as a routing layer.
• Put long explanations in references/.
• Keep templates user-editable and avoid filling real identity content.
• Keep adapter files thin to avoid rule drift.