Skip to content

Merge research and content skills into kagi-usage, add Claude Code plugin - #146

Merged
Microck merged 6 commits into
Microck:mainfrom
ariesclark:skills-plugin-and-merge
Jul 27, 2026
Merged

Merge research and content skills into kagi-usage, add Claude Code plugin#146
Microck merged 6 commits into
Microck:mainfrom
ariesclark:skills-plugin-and-merge

Conversation

@ariesclark

@ariesclark ariesclark commented Jul 26, 2026

Copy link
Copy Markdown
Contributor

Summary

  • adds a Claude Code plugin manifest and single-plugin marketplace for this repository
  • merges the old research and page-content skills into one canonical kagi-usage guide
  • adds kagi-ai for spending Assistant allowance on reasoning, coding, research, file analysis, and structured output
  • keeps kagi-assistant, kagi-monitoring, and kagi-account-config focused on their own workflows
  • updates CLI help, embedded registry tests, docs, and the 0.15.0 release notes

Verification

  • cargo fmt --check
  • cargo clippy --all-targets --all-features -- -D warnings
  • cargo check --workspace --all-targets --locked
  • cargo test --workspace --all-targets --locked (273 passed, 13 ignored)
  • cargo audit
  • claude plugin validate --strict .claude-plugin/plugin.json
  • claude plugin validate --strict .claude-plugin/marketplace.json
  • quick_validate.py skills/kagi-ai

Docs

  • README updated if user-facing behavior changed
  • CHANGELOG updated for notable user-facing changes
  • docs/commands/skills.mdx lists the canonical skill set

Auth / Secrets

  • No tokens, cookies, or local config secrets were committed
  • Live verification used configured auth without printing credential values

Greptile Summary

Consolidates Kagi’s embedded agent guidance and adds Claude Code plugin packaging.

  • Replaces the research, content, and router guides with the unified kagi-usage skill.
  • Adds kagi-ai guidance for paid Assistant workflows.
  • Adds Claude Code plugin and marketplace manifests.
  • Updates CLI help, documentation, and integration tests for the new skill names.

Confidence Score: 5/5

The PR appears safe to merge because no new blocking failure eligible for this follow-up review remains.

No blocking failure remains within the scope of the displayed previous review thread.

T-Rex T-Rex Logs

What T-Rex did

  • The CLI help was examined and shows a directive pointing agents to the kagi-usage command.
  • The skill listing was checked and confirms kagi-usage is available while retired guides are not listed.
  • The embedded guide for kagi-usage was reviewed and found to begin with usable web-search and page-content guidance.
  • The skill path resolution was validated to map to embedded://skills/kagi-usage.

View all artifacts

T-Rex Ran code and verified through T-Rex

Important Files Changed

Filename Overview
src/agent.rs Updates the embedded skill registry to use kagi-usage and adds the new kagi-ai skill.
skills/kagi-usage/SKILL.md Introduces unified guidance for web search, page-content workflows, and routing to specialized skills.
skills/kagi-ai/SKILL.md Adds guidance for Assistant allowance, model selection, file analysis, and structured output.
.claude-plugin/marketplace.json Adds the single-plugin Claude Code marketplace definition.
.claude-plugin/plugin.json Adds the Claude Code plugin manifest.
tests/integration-cli.rs Updates integration expectations for the renamed core skill and expanded registry.

Reviews (2): Last reviewed commit: "feat(skills): add cost-aware kagi-ai gui..." | Re-trigger Greptile

Summary by CodeRabbit

  • New Features

    • Added Claude Marketplace plugin manifests, enabling installation as a Claude Code plugin.
    • Added unified kagi-usage guidance for search and page workflows.
    • Added kagi-ai guidance for AI allowance management, model selection, files, and structured outputs.
    • Added focused guidance for Assistant conversations, monitoring, and account configuration.
  • Documentation

    • Updated CLI help, README, changelog, and skills documentation to reflect the new skill names and routing.
    • Removed obsolete research, content, and legacy router guidance.

@ariesclark
ariesclark requested a review from Microck as a code owner July 26, 2026 22:00
@coderabbitai

coderabbitai Bot commented Jul 26, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 07be9367-6f4e-4a77-a75e-f28db0d19bf6

📥 Commits

Reviewing files that changed from the base of the PR and between a4e5690 and 775a848.

📒 Files selected for processing (7)
  • CHANGELOG.md
  • docs/commands/skills.mdx
  • skills/kagi-ai/SKILL.md
  • skills/kagi-assistant/SKILL.md
  • skills/kagi-usage/SKILL.md
  • src/agent.rs
  • tests/integration-cli.rs
🚧 Files skipped from review as they are similar to previous changes (7)
  • skills/kagi-ai/SKILL.md
  • CHANGELOG.md
  • docs/commands/skills.mdx
  • src/agent.rs
  • skills/kagi-usage/SKILL.md
  • skills/kagi-assistant/SKILL.md
  • tests/integration-cli.rs

📝 Walkthrough

Walkthrough

The PR adds Claude plugin manifests, introduces kagi-usage as the core embedded skill, adds kagi-ai, removes former registry entries, updates skill guidance and CLI documentation, and aligns integration tests with the revised skill names.

Changes

Claude skill registry and guidance

Layer / File(s) Summary
Core usage skill and registry
skills/kagi-usage/SKILL.md, skills/kagi-ai/SKILL.md, src/agent.rs
Adds the kagi-usage and kagi-ai guides and updates the embedded registry and registry tests.
Skill documentation updates
docs/commands/skills.mdx, README.md, skills/kagi-*/SKILL.md, CHANGELOG.md
Updates skill names, routing examples, workflow guidance, headings, completion criteria, and release notes.
CLI help and integration validation
src/cli.rs, tests/integration-cli.rs
Updates displayed commands and test expectations for kagi-usage, the revised listing, embedded path, and full guide retrieval.
Claude plugin manifests
.claude-plugin/marketplace.json, .claude-plugin/plugin.json
Adds marketplace and plugin metadata for the kagi Claude plugin.

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

🚥 Pre-merge checks | ✅ 6
✅ Passed checks (6 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly captures the main change: consolidating skills into kagi-usage and adding Claude Code plugin support.
Description check ✅ Passed The description matches the required template with completed Summary, Verification, Docs, and Auth / Secrets sections.
Docstring Coverage ✅ Passed Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Release Metadata Consistency ✅ Passed Cargo.toml, Cargo.lock kagi package, npm/package.json, and CHANGELOG.md all show version 0.15.0.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

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

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a2ff493e4b

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment thread skills/kagi-usage/SKILL.md Outdated

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🧹 Nitpick comments (1)
.claude-plugin/plugin.json (1)

4-4: 🩺 Stability & Availability | 🔵 Trivial | ⚡ Quick win

Keep a single authoritative plugin version.

Both manifests declare the plugin version. Claude Code prioritizes plugin.json, so a future bump made only in the marketplace entry can be ignored and prevent users from receiving updates. The official documentation recommends avoiding duplicate version declarations. (code.claude.com)

  • .claude-plugin/plugin.json#L4-L4: retain this as the authoritative plugin version and bump it for releases.
  • .claude-plugin/marketplace.json#L16-L16: remove the duplicate plugin-level version field; keep metadata.version for the marketplace itself.
Proposed fix
       "source": "./",
       "description": "Kagi CLI skills for research, page content, Assistant, monitoring, and account configuration.",
-      "version": "0.15.0",
       "author": {
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @.claude-plugin/plugin.json at line 4, Keep the version in
.claude-plugin/plugin.json as the authoritative plugin version and continue
bumping it for releases; remove only the duplicate plugin-level version field
from .claude-plugin/marketplace.json while preserving marketplace
metadata.version.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@skills/kagi-usage/SKILL.md`:
- Around line 44-46: Update the authentication description near the Search API
notes to replace the broad “search filters require session auth” wording with
“session-only search controls,” matching the terminology used around the
relevant quick, subscriber search, and filter behavior. Keep the documented V1
API filters usable with KAGI_API_KEY.

---

Nitpick comments:
In @.claude-plugin/plugin.json:
- Line 4: Keep the version in .claude-plugin/plugin.json as the authoritative
plugin version and continue bumping it for releases; remove only the duplicate
plugin-level version field from .claude-plugin/marketplace.json while preserving
marketplace metadata.version.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: fa1eab38-e671-4ea1-8b31-503343c61ca0

📥 Commits

Reviewing files that changed from the base of the PR and between 9fb4689 and a2ff493.

📒 Files selected for processing (14)
  • .claude-plugin/marketplace.json
  • .claude-plugin/plugin.json
  • README.md
  • docs/commands/skills.mdx
  • skills/kagi-account-config/SKILL.md
  • skills/kagi-assistant/SKILL.md
  • skills/kagi-content/SKILL.md
  • skills/kagi-monitoring/SKILL.md
  • skills/kagi-research/SKILL.md
  • skills/kagi-usage/SKILL.md
  • skills/kagi/SKILL.md
  • src/agent.rs
  • src/cli.rs
  • tests/integration-cli.rs
💤 Files with no reviewable changes (3)
  • skills/kagi-research/SKILL.md
  • skills/kagi-content/SKILL.md
  • skills/kagi/SKILL.md

Comment thread skills/kagi-usage/SKILL.md Outdated
Comment thread src/agent.rs
@Microck

Microck commented Jul 27, 2026

Copy link
Copy Markdown
Owner

@greptileai review

@Microck

Microck commented Jul 27, 2026

Copy link
Copy Markdown
Owner

@codex review

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@src/agent.rs`:
- Around line 11-13: Preserve the legacy aliases kagi, kagi-research, and
kagi-content while keeping kagi-usage as the sole canonical registry entry.
Update skill_source and skill_locator to canonicalize those inputs before
exact-name lookup, so aliases resolve to the kagi-usage content and path. Add
regression tests covering both content retrieval and locator/path lookup for
each alias.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 514f4852-4988-497b-8e0c-0b97e53fee04

📥 Commits

Reviewing files that changed from the base of the PR and between 895a789 and a4e5690.

📒 Files selected for processing (7)
  • CHANGELOG.md
  • docs/commands/skills.mdx
  • skills/kagi-ai/SKILL.md
  • skills/kagi-assistant/SKILL.md
  • skills/kagi-usage/SKILL.md
  • src/agent.rs
  • tests/integration-cli.rs
🚧 Files skipped from review as they are similar to previous changes (3)
  • docs/commands/skills.mdx
  • skills/kagi-assistant/SKILL.md
  • tests/integration-cli.rs

Comment thread src/agent.rs

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a4e5690cfa

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread src/agent.rs

@Microck Microck left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

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

looks good imo

@Microck
Microck enabled auto-merge July 27, 2026 00:20
@Microck
Microck disabled auto-merge July 27, 2026 00:24
@Microck
Microck force-pushed the skills-plugin-and-merge branch from a4e5690 to 895a789 Compare July 27, 2026 00:24
@greptile-apps

greptile-apps Bot commented Jul 27, 2026

Copy link
Copy Markdown

PR title or description contains an excluded keyword.

Embed a focused AI allowance guide, wire it into routing and docs, and cover it in registry tests. Fix Claude skill frontmatter validation and format the updated CLI test.
@Microck
Microck merged commit 5a4d0ae into Microck:main Jul 27, 2026
4 checks 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