mcpkernel: Skill for Claude Code

.github/skills/docs-sync/SKILL.md

docs-sync is a skill for Claude Code, Codex from piyushptiwari1/mcpkernel. It costs 47 tokens per session (830 once invoked), scanned A, original, Apache-2.0.

A documentation-audit workflow for checking a Python project’s README, MkDocs website, usage guides and changelog against the code. MkDocs is a tool that builds documentation websites from Markdown files.

In plain words
What is it for?
Use it to review README.md and docs/, check the MkDocs navigation and build, verify code examples and public APIs, and update documentation when it no longer matches the project.
Why use it?
It finds outdated examples, links, version details, feature descriptions and API references after code changes or before a release.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

This is piyushptiwari1/mcpkernel's own configuration. It tells Claude Code and Codex how to work on mcpkernel itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything mcpkernel configures →

Reuse

Borrowing it

Nothing to install: this file belongs to piyushptiwari1/mcpkernel. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/piyushptiwari1/mcpkernel/main/.github/skills/docs-sync/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/piyushptiwari1/mcpkernel

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for docs-sync

README.md
[![agentmods](https://agentmods.dev/badge/skills/piyushptiwari1/mcpkernel/docs-sync/github.svg)](https://agentmods.dev/skills/piyushptiwari1/mcpkernel/docs-sync)
Your own site
<a href="https://agentmods.dev/skills/piyushptiwari1/mcpkernel/docs-sync"><img src="https://agentmods.dev/badge/skills/piyushptiwari1/mcpkernel/docs-sync/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for docs-sync

Your own site · 80×15
<a href="https://agentmods.dev/skills/piyushptiwari1/mcpkernel/docs-sync"><img src="https://agentmods.dev/badge/skills/piyushptiwari1/mcpkernel/docs-sync.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 47 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 830 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00047 $0.00830
Opus 5.5 $0.00019 $0.00332
Sonnet 5.5 $0.00009 $0.00166
Haiku 4.5 $0.00005 $0.00083

Measured 1mo ago against content hash 16585a7b0286, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

docs-sync scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.github/skills/docs-sync/SKILL.md · 86 lines

How it starts

The opening of the file, as written. The whole thing — 86 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Documentation Sync Workflow

When to Use

  • After a batch of code changes to sync docs
  • Before preparing a release
  • When public APIs have changed
  • Regular documentation audits
  • After adding new features or CLI commands

Documentation Site

MCPKernel uses MkDocs Material for documentation, hosted at:

Procedure

Step 1: Audit README.md

  1. Read README.md
  2. Verify:
    • Docs badge and link to https://piyushptiwari1.github.io/mcpkernel/
    • Python version badge matches pyproject.toml
    • Quick start commands work
    • Feature list matches actual packages in src/mcpkernel/
    • Architecture diagram is accurate
    • All links are valid
    • Test count and coverage percentage are current

Step 2: Audit MkDocs Site (docs/)

  1. Read mkdocs.yml for nav structure
  2. For each page in docs/:
    • Cross-reference code examples against source files
    • Verify method signatures, parameter names, return types
    • Check CLI commands match mcpkernel <cmd> --help output
    • Verify import paths are correct
    • Ensure expected output examples are structurally plausible
  3. Key cross-references:
    • docs/trust/ ↔ src/mcpkernel/trust/
    • docs/security/ ↔ src/mcpkernel/security.py
    • docs/compliance/ ↔ src/mcpkernel/compliance.py
    • docs/core/ ↔ src/mcpkernel/policy/, taint/, sandbox/, dee/, audit/
    • docs/cli/ ↔ src/mcpkernel/cli.py
    • docs/api/ ↔ src/mcpkernel/api.py

Step 3: Update CHANGELOG.md

  1. Check git log for unreleased changes:
    git log --oneline --since="last tag"
    
  2. Categorize changes: Added, Changed, Fixed, Security
  3. Add entries under [Unreleased] section

Step 4: Update CONTRIBUTING.md

  1. Verify build/test commands are current
  2. Check docs section references MkDocs Material and the live site URL

Read the full file on GitHub · 86 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 86 lines · 47 tokens per session scan A 16585a7b0286

Subscribe to this mod's changes

docs-sync is a skill published in the GitHub repository piyushptiwari1/mcpkernel (2 stars, last pushed 4mo ago), licensed Apache-2.0. It adds 47 tokens to every session and 830 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

skill-inspector

Review AI agent skills before installation using NVIDIA SkillSpector and source-aware semantic review. Use when asked whether a skill or downloaded skill folder is safe, trustworthy, installable, over-permissioned, or malicious.

NVIDIA/SkillSpector · 47 tokens

integrate-arcjet-guard-claude-agent-sdk

Integrate Arcjet security into a Claude Agent SDK agent using @arcjet/guard — wrap tool() handlers, screen inbound prompts with UserPromptSubmit, and deny unwrapped built-in/MCP tools with PreToolUse. Use when asked to add Arcjet to a Claude Agent SDK or Claude Code agent, rate limit its tools, screen inbound…

arcjet/arcjet-js · 92 tokens

integrate-arcjet-guard-genkit

Integrate Arcjet security into a Genkit JS agent using @arcjet/guard — wrap ai.defineTool, put guardMiddleware on generate({ use }) for unwrapped / MCP / filesystem tools, and read a caller-owned id from generate({ context }). Use when asked to add Arcjet to genkit, rate limit its tools, screen inbound messages, or…

arcjet/arcjet-js · 89 tokens

integrate-arcjet-guard-langchain

Integrate Arcjet security into a LangChain JS createAgent using @arcjet/guard — wrap tool() / StructuredTool, put guardMiddleware on createAgent({ middleware }) for MCP / unwrapped tools, and read configurable.threadid for correlation. Use when asked to add Arcjet to langchain createAgent, rate limit its tools, screen…

arcjet/arcjet-js · 101 tokens

integrate-arcjet-guard-google-adk

Integrate Arcjet security into a Google ADK JS app using @arcjet/guard — put guardPlugin first on Runner({ plugins }) so beforeToolCallback gates tools, and read a caller-owned id from helper options or context. Use when asked to add Arcjet to Google ADK, @google/adk, rate limit its tools, screen inbound messages, or…

arcjet/arcjet-js · 111 tokens

integrate-arcjet-guard-tanstack-ai

Integrate Arcjet security into a TanStack AI chat() app using @arcjet/guard — put guardMiddleware first on chat({ middleware }) so onBeforeToolCall gates tools, and read a caller-owned id from chat({ context }). Use when asked to add Arcjet to TanStack AI, rate limit its tools, screen inbound messages, or block prompt…

arcjet/arcjet-js · 103 tokens