@zhangweiii/skills

Web search and fetch tools, compatible with pi, Claude Code, Codex, Cursor, and any agent that supports the open skills standard. Uses the Moonshot (Kimi) API for internet search and URL content fetching. Trigger when you need real-time information, web page retrieval, or online research.

中文文档

Skills

Skill	Description	Trigger Context
kimi-web-search	Web search and page fetching (Moonshot API)	Internet search, URL content retrieval, real-time info lookup

See each skill's SKILL.md for detailed API docs, usage examples, and configuration.

Installation

pi users

Recommended — via npm:

pi install npm:@zhangweiii/skills

Update later:

pi update npm:@zhangweiii/skills

Alternative — via git:

pi install git:github.com/zhangweiii/skills

Enable only one skill (filter out the rest):

pi config --skills   # interactively choose which skills to enable

Or specify exactly in ~/.pi/agent/settings.json:

{
  "packages": [
    {
      "source": "npm:@zhangweiii/skills",
      "skills": ["skills/kimi-web-search"]
    }
  ]
}

Invoke in session:

/skill:kimi-web-search

Other agents (Claude Code, Codex, Cursor, ...)

npx skills add zhangweiii/skills

Or install a specific skill only:

npx skills add zhangweiii/skills --skill kimi-web-search

Configuration

kimi-web-search

Requires a Moonshot (Kimi) subscription and the following environment variables:

Variable	Required	Default	Description
KIMI_API_KEY	Yes	—	Bearer token for Authorization. Must be set.
SEARCH_BASE_URL	No	https://api.kimi.com/coding/v1/search	Search endpoint. Override for a different provider.
FETCH_BASE_URL	No	https://api.kimi.com/coding/v1/fetch	Fetch endpoint. Override for a different provider.

Set before running:

export KIMI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx

Or configure in your agent's settings. If KIMI_API_KEY is missing, the skill halts with a prompt to configure it.

These endpoints are part of the Model Context Protocol (MCP) infrastructure, not standard chat-completion APIs. If you get 403 Forbidden, verify that your Moonshot account has the search/fetch service enabled.

Manual install (any agent)

Copy subdirectories under skills/ into your agent's skills directory:

Agent	Path
pi	~/.pi/agent/skills/
Kimi CLI	~/.kimi/skills/
Claude Code	~/.claude/skills/
Generic	.agents/skills/

Repository Structure

skills/
├── README.md                 # This file: repo overview and install guide
├── README.zh.md              # Chinese version of this README
├── package.json              # pi package manifest
├── skills/                   # All skill directories
│   └── kimi-web-search/
│       └── SKILL.md          # Core skill instructions (API spec, calling guide)
└── scripts/                  # Repo-wide shared scripts
    └── search.ts             # TypeScript CLI helper

Scripts

Some skills ship with standalone CLI scripts for quick testing:

TypeScript (requires Node.js 18+):

npx tsx scripts/search.ts search "Python 3.12 release notes"
npx tsx scripts/search.ts fetch "https://docs.python.org/3/whatsnew/3.12.html"

Adding a New Skill

1. Create a new directory under skills/, use lowercase kebab-case (e.g. my-skill)
2. Write a SKILL.md with:
   • YAML frontmatter (name + description; description must contain "Use when..." trigger conditions)
   • Quick start, workflows, advanced features
3. If it exceeds 100 lines, split into REFERENCE.md or EXAMPLES.md
4. Put deterministic operation scripts in scripts/ or the skill's own scripts/ subdir
5. Update the Skills table in this README

Reference: write-a-skill best practices

License

MIT