Skip to content

refactor(okf): move okf skill to dot_agents, symlink from dot_claude - #902

Merged
yxtay merged 1 commit into
mainfrom
refactor/okf-move-to-agents
Jul 16, 2026
Merged

refactor(okf): move okf skill to dot_agents, symlink from dot_claude#902
yxtay merged 1 commit into
mainfrom
refactor/okf-move-to-agents

Conversation

@yxtay

@yxtay yxtay commented Jul 16, 2026

Copy link
Copy Markdown
Owner

Summary

  • Moves okf skill from private_dot_claude/skills/okf/ to private_dot_agents/skills/okf/ — consistent with the pattern where .agents/skills/ is the source and .claude/skills/ symlinks to it
  • Adds symlink_okf in private_dot_claude/skills/ (chezmoi-managed symlink → ../../.agents/skills/okf)
  • Removes mattpocock-skills@mattpocock plugin install — all mattpocock skills are already installed selectively via npx skills add in run_onchange_after_agent_plugins.sh.tmpl, so the plugin was loading 39 full SKILL.md files (~165k chars, ~41k tokens) into every session unnecessarily
  • Improves okf-wiki-review.txt prompt: more liberal capture criteria (5 how/why/what bullets), cleaner wording
  • Cleans up SKILL.md: renames ModesTask types, removes inline "Done when" clauses (consolidated into existing "Before declaring done" section), removes redundant trigger wording from description
  • Fixes template punctuation consistency and timestamp example

Test plan

  • chezmoi apply deploys ~/.claude/skills/okf as symlink → ../../.agents/skills/okf
  • ~/.agents/skills/okf/ contains hooks/, dot_claude-plugin/, SKILL.md, SPEC.md, templates/
  • okf skill appears in Claude Code skills list
  • okf-wiki-maintenance hook fires on SessionStart/End and writes to ~/wiki/
  • mattpocock-skills plugin no longer in installed plugins after fresh chezmoi apply

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Added automatic OKF wiki maintenance during session start and end.
    • Added unattended guidance for reviewing recent memory and updating durable wiki knowledge.
    • Claude Code is now detected and configured automatically when available.
    • Consolidated OKF skill access through a shared skill location.
  • Improvements

    • Updated OKF guidance, templates, and metadata for clearer maintenance workflows.
    • Simplified the configured skill set and removed redundant OKF copies and plugin setup.

- Move okf skill source from private_dot_claude/skills/okf/ to
  private_dot_agents/skills/okf/ to match the pattern used by all
  other skills (agents is source, claude symlinks to it)
- Add chezmoi symlink_okf in private_dot_claude/skills/ pointing to
  ../../.agents/skills/okf
- Merge hooks/, dot_claude-plugin/ into private_dot_agents/okf/
- Remove mattpocock-skills@mattpocock plugin install — skills are
  installed selectively via npx skills in agent_plugins script
- Remove mattpocock/skills marketplace entry from setup_claude script
- Update okf-wiki-review.txt: more liberal capture criteria, improved
  wording (drop "daily", clearer synthesized summaries guidance)
- SKILL.md: rename Modes → Task types, consolidate Done-when clauses,
  clean up description redundancy
- Templates: realistic timestamp example, consistent list punctuation

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Jul 16, 2026

Copy link
Copy Markdown

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: e99a88a4-739f-4f4a-98de-1c3f04917614

📥 Commits

Reviewing files that changed from the base of the PR and between b23481d and a7a2cb7.

📒 Files selected for processing (16)
  • chezmoi/.chezmoiscripts/run_onchange_after_agent_plugins.sh.tmpl
  • chezmoi/.chezmoiscripts/run_onchange_after_setup_claude.sh.tmpl
  • chezmoi/private_dot_agents/skills/okf/SKILL.md
  • chezmoi/private_dot_agents/skills/okf/dot_claude-plugin/plugin.json
  • chezmoi/private_dot_agents/skills/okf/hooks/executable_okf-wiki-maintenance.sh
  • chezmoi/private_dot_agents/skills/okf/hooks/hooks.json
  • chezmoi/private_dot_agents/skills/okf/hooks/okf-wiki-review.txt
  • chezmoi/private_dot_agents/skills/okf/templates/concept.md
  • chezmoi/private_dot_agents/skills/okf/templates/log.md
  • chezmoi/private_dot_claude/skills/okf/SKILL.md
  • chezmoi/private_dot_claude/skills/okf/SPEC.md
  • chezmoi/private_dot_claude/skills/okf/hooks/okf-wiki-review.txt
  • chezmoi/private_dot_claude/skills/okf/templates/concept.md
  • chezmoi/private_dot_claude/skills/okf/templates/index.md
  • chezmoi/private_dot_claude/skills/okf/templates/log.md
  • chezmoi/private_dot_claude/skills/symlink_okf

📝 Walkthrough

Walkthrough

The changes conditionally register Claude Code, revise Matt Pocock skill installation, and migrate OKF functionality into an agents plugin with updated templates, lifecycle hooks, runbook instructions, and a Claude skill-directory symlink.

Changes

Agent plugin configuration

Layer / File(s) Summary
Conditional agent and skill setup
chezmoi/.chezmoiscripts/run_onchange_after_agent_plugins.sh.tmpl, chezmoi/.chezmoiscripts/run_onchange_after_setup_claude.sh.tmpl
Claude Code is added when the executable exists, the configured Matt Pocock skills are replaced, and the corresponding Claude marketplace and plugin installation entries are removed.

OKF plugin migration

Layer / File(s) Summary
OKF skill contract and templates
chezmoi/private_dot_agents/skills/okf/SKILL.md, chezmoi/private_dot_agents/skills/okf/dot_claude-plugin/plugin.json, chezmoi/private_dot_agents/skills/okf/templates/*
OKF invocation guidance and completion checks are revised, an okf plugin manifest is added, and concept/log templates are updated.
OKF maintenance lifecycle
chezmoi/private_dot_agents/skills/okf/hooks/*
SessionStart and SessionEnd asynchronously invoke the wiki maintenance hook, with an unattended maintenance runbook and updated hook documentation.
Claude skill directory linkage
chezmoi/private_dot_claude/skills/okf, chezmoi/private_dot_claude/skills/okf/*
The previous vendored Claude OKF files are removed and the Claude skill path points to the agents implementation.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Possibly related PRs

Poem

A bunny hops through hooks at dawn,
Claude’s old plugin trail is gone.
OKF blooms in agents’ den,
Journals turn to wiki zen.
Templates tidy, links align—
Carrots celebrate the design! 🐇

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch refactor/okf-move-to-agents

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

Copy link
Copy Markdown
Contributor

MegaLinter analysis: Success

Descriptor Linter Files Fixed Errors Warnings Elapsed time
✅ BASH shfmt 5 0 0 0 0.02s
✅ JSON prettier 7 0 0 0 0.44s
✅ MARKDOWN markdownlint 9 0 0 0 0.69s
✅ MARKDOWN markdown-table-formatter 11 0 0 0 0.15s
✅ YAML prettier 11 0 0 0 0.49s

Notices

📣 MegaLinter 9.5.0 is out! Discover the new features and security recommendations in the release announcement. (Skip this info by defining SECURITY_SUGGESTIONS: false)

See detailed reports in MegaLinter artifacts

Your project could benefit from a custom flavor, which would allow you to run only the linters you need, and thus improve runtime performances. (Skip this info by defining FLAVOR_SUGGESTIONS: false)

  • Documentation: Custom Flavors
  • Command: npx mega-linter-runner@9.6.0 --custom-flavor-setup --custom-flavor-linters BASH_SHFMT,JSON_PRETTIER,MARKDOWN_MARKDOWNLINT,MARKDOWN_MARKDOWN_TABLE_FORMATTER,YAML_PRETTIER

MegaLinter is graciously provided by OX Security
Show us your support by starring ⭐ the repository

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Code Review

This pull request updates agent plugins and the Open Knowledge Format (OKF) skill configuration. It introduces conditional logic to add claude-code to the agents list, cleans up old skill references, refactors the okf skill documentation and templates, and adds a new wiki review hook instruction file. Feedback on the changes recommends conditionally adding opencode to the agents list as well, and exiting the script early if no agents are found to prevent potential execution failures.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread chezmoi/.chezmoiscripts/run_onchange_after_agent_plugins.sh.tmpl
@yxtay
yxtay merged commit ec227a1 into main Jul 16, 2026
18 of 20 checks passed
@yxtay
yxtay deleted the refactor/okf-move-to-agents branch July 16, 2026 02:11
@coderabbitai coderabbitai Bot mentioned this pull request Aug 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant