Zephex Agent Skills

Teach Claude Code, Cursor, and other agents how to use Zephex MCP and the zephex terminal CLI on the user's own repository.

Install the skill

npx skills add zephexMCP/agent-skills
# or
npx skills add https://github.com/zephexmcp/agent-skills --skill zephex

Prerequisites

Need	How
MCP in editor	`npx zephex setup` (or copy from `configs/`)
API key	zephex.dev/dashboard/api-keys
Terminal CLI (optional)	`curl -fsSL https://zephex.dev/cli/install.sh \| bash`

https://zephex.dev/cli/install.sh and https://zephex.dev/install.sh are the same installer. Windows: irm https://zephex.dev/install.ps1 | iex.

What ships for agents

File	Role
`skills/zephex/SKILL.md`	Full routing: 10 tools + CLI commands
`AGENTS.md`	Short session gate
`CLAUDE.md`	Claude Code preferences
`configs/*`	Optional manual MCP templates

Ten MCP tools

Deep public catalog (examples + CLI map): zephex-tools · On-site: docs/tools

Tool	Purpose
`get_project_context`	Framework, scripts, env, monorepo (topic slices)
`find_code`	BM25 + ripgrep search
`read_code`	AST symbol / file / outline
`explain_architecture`	Wiring map + Mermaid-capable deep mode
`check_package`	Registry safety, CVEs, upgrades (12 ecosystems)
`check_test`	Test Pulse — run suite + failure health
`audit_headers`	Live HTTPS URL audit
`project_memory`	Remember / recall project facts
`keep_thinking`	Multi-step reasoning + loop detection
`Zephex_dev_info`	Expert implementation playbooks

CLI highlights (Mode 2)

curl -fsSL https://zephex.dev/cli/install.sh | bash
cd your-project && zephex login
zephex deep --json                 # orientation packet for agents
zephex structure --agent           # free folder map
zephex architecture --focus auth
zephex overview
zephex find "auth middleware"
zephex test                        # run suite
zephex check test failures         # after test
zephex check test fix-prompt --copy
zephex safe lodash
zephex learn                       # free catalog

Maintainers

SKILL-MAINTAINER.md — sync with mcpHub product tools
TRIGGER-EVAL.md — description eval
SECURITY.md — intentional MCP/CLI surfaces (for auditors)
Before push: node scripts/eval-description.mjs (20/20)

Ground truth: mcpHub available-tools.ts + proxy tool schemas.

skills.sh page looks stale?

There is no “publish” button. skills.sh indexes via install telemetry + cached snapshots. GitHub main is the source of truth; the catalog Overview/Snyk can lag for weeks (#919, #1273).

Check	Expected (current product)
raw SKILL.md	Call order starts with `get_project_context` → `find_code`; no `scope_task` / `inspect_url`
download API	Should match GitHub after reindex (stale if it still lists `references/tools.md`)
Snyk page	May still show May 2026 W011 until re-audit

Install always clones GitHub, not the skills.sh HTML cache:

npx skills add zephexMCP/agent-skills --skill zephex -y
npx skills update zephex -y

Nudge reindex: reinstall via CLI, then if download API stays stale, open an issue on vercel-labs/skills.

License

See LICENSE.

Related discovery repos

Repo	Role
zephex-MCPs	Product overview
zephex-tools	Ten tools deep catalog
zephex-cli	Mode 2 CLI
zephex-web-terminal	Browser terminal
llms.txt	Agent product truth