Skip to content

docs: cross-link vault-onboarding companion skill; add pkm keywords - #410

Draft
aliasunder wants to merge 12 commits into
mainfrom
docs/vault-onboarding-crosslink
Draft

docs: cross-link vault-onboarding companion skill; add pkm keywords#410
aliasunder wants to merge 12 commits into
mainfrom
docs/vault-onboarding-crosslink

Conversation

@aliasunder

Copy link
Copy Markdown
Owner

Cross-links the new companion project and aligns discovery metadata:

  • README: new "Companion: vault-onboarding skill" section, same skeleton as the obsidian-vault companion — what it bootstraps, install command, source link. Placed directly after the existing companion section.
  • generate-dockerhub-readme.ts: the new H2 added to EXCLUDED_H2; regenerated DOCKERHUB.md is byte-identical (companion sections don't ship to Docker Hub).
  • package.json keywords: attachmentspkm + personal-knowledge-management (kept pdf), matching the GitHub topics update made earlier tonight.

Post-merge step (maintainer): npm run publish:lobehub — the LobeHub listing's tags are generated from package.json keywords.

🤖 Generated with Claude Code

New Companion section mirrors the obsidian-vault one — vault-onboarding
bootstraps the collaboration system this server powers, standalone or
vault-cortex-connected. Its H2 joins EXCLUDED_H2 so it stays out of
DOCKERHUB.md (regenerated: byte-identical). Keywords swap attachments
for pkm + personal-knowledge-management, matching the GitHub topics
update; LobeHub listing tags derive from keywords, so publish:lobehub
needs a run after merge.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@umm-actually

umm-actually Bot commented Aug 6, 2026

Copy link
Copy Markdown

umm-actually re-reviewed at 78cbc2b

No new findings (1 tracked finding(s) across all runs).

Context notes
  • Priority docs already in context: README.md

umm-actually · deepseek/deepseek-v4-flash-0731

@aliasunder
aliasunder marked this pull request as draft August 6, 2026 05:51
@aliasunder

Copy link
Copy Markdown
Owner Author

Draft until vault-onboarding completes Stage 5 validation (install test + interview-path walkthroughs, planned for Fri/weekend) — the companion section shouldn't advertise the skill from this README while it's still pre-validation. Mark ready + merge once validation passes, then run npm run publish:lobehub for the keyword change.

🤖 Generated with Claude Code

aliasunder and others added 4 commits August 6, 2026 01:53
Same pkm + personal-knowledge-management pair as the root package and
GitHub topics — the CLI is the npm-facing surface where keywords power
search, and the first organic community mention of vault-cortex came
from r/PKMS. Goes live on the next CLI publish.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Comment thread cli/package.json
Comment on lines +39 to 41
"second-brain",
"pkm",
"personal-knowledge-management",

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Align PR description with the actual keyword change
Low severity · subtle bugs · high confidence

The PR description claims package.json keywords were changed as attachments → pkm + personal-knowledge-management (kept pdf), but the diff only adds second-brain to cli/package.json; attachments remains in the list and pkm/personal-knowledge-management were already present before this PR.

Failure scenario: A maintainer relying on the PR description to review the keyword change believes attachments was removed from the published npm package's keywords, but it is still shipped, so the LobeHub listing (generated from these keywords post-merge) still advertises attachments while the description claimed otherwise.

Suggested fix
Update the PR description to state that `second-brain` was added to align cli/package.json keywords with the root package.json and GitHub topics, and that `attachments` was retained.

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