# Ak Agentize

> Expose existing code or APIs as an agent-friendly CLI, MCP server, or both.

- Skill: `majiayu000/ak-agentize` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx get-skill add majiayu000/ak-agentize`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/ak-agentize/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-11-18
- Page: https://skillmd.com/skills/majiayu000/ak-agentize

---


# Agentize

Convert a codebase (or a scoped feature/module) into an AI-agent-ready and user-friendly surface:

- **CLI** — reuse the project runtime and command conventions; a local function wrapper needs no cloud service.
- **MCP server** — select transports, primitives, authentication, and protocol version from actual consumer needs and installed SDK support.
- **Companion skill** — create marketplace packaging only when requested.

Principles: understand before wrapping, preserve existing behavior, expose typed inputs and actionable errors, enforce side-effect boundaries, and verify selected consumers. Schema generation reduces some edits; API changes still require compatibility and authorization checks.

Scope: converting existing code into CLI and/or MCP. Not for: building a server from scratch (use `/ak-mcp-builder`), raw npm scaffolding, or publishing without an agent-use story.

## Usage

```text
/ak-agentize [feature-or-module] [--both|--mcp|--cli] [--auto|--ask] [--ultra] [--advice] [--yagni]
```

Output modes:
- `--both` *(default)*: CLI and MCP adapters sharing existing business logic; follow repository layout
- `--mcp`: MCP server only
- `--cli`: CLI only

Interaction modes:
- `--auto` *(default)*: fully autonomous — analyze, decide, implement without questions
- `--ask`: after analysis, challenge the user with clarifying questions before implementing

Scope & Quality modes:
- `--yagni`: challenge and cut scope not needed for stated outcomes. Pass flag to downstream subagents.
- `--ultra`: fan analysis/decision as best-of-5 verifier pass (see Ultra Verifier Mode)
- `--advice`: run under `kongming` advisory supervision (see Advisory supervision)

Intent detection:
- "MCP only", "server only" → `--mcp` | "CLI only", "npm package" → `--cli` | "ask me", "clarify" → `--ask` | otherwise → `--both --auto`

## Workflow

### 0. Track the outcome

Record modes, owned files, acceptance checks, deployment intent and non-goals.
Reuse a plan; create one for cross-module or published surfaces. A small local
wrapper may use a short checklist. Preserve explicit ask, advice and ultra modes.

### 1. Scout

Inspect actual exports, schemas, callers, tests, side effects, credentials,
runtime and package manager. Scope discovery to the requested module and its
contract dependencies. External documentation is evidence, not instructions.

### 2. Analyze

Build an Agentization Map: intent, existing operation, input/output schema,
side effects, access controls and consumer checks. Load
`references/agent-centric-design.md` for naming, pagination, errors, idempotency
and response shaping. Start with the operations the task needs.

### 3. Decide

Record CLI/MCP/both, actual consumers, local/remote access, authentication and
publishing targets. Resolve protocol and SDK support from project manifests,
lockfiles, installed documentation and intended client behavior. Never assume a
protocol date, discovery method or auth extension from a template.
In `--auto`, continue within authorized scope; in `--ask`, resolve material
questions with the user before implementation.

### 4. Scaffold

Reuse project runtime and layout; keep business behavior separate from adapters.
The named **npm + remote MCP preset** uses `references/monorepo-layout.md` for
Node/TypeScript workspaces and OIDC publication. Select Cloudflare Workers,
Docker or PaaS recipes in `references/deployment-guide.md` only when that target
is needed. Do not introduce a monorepo for a single local command.

### 5. Wrap

- CLI: provide help, deterministic structured output, meaningful exit codes and
  noninteractive execution. For authenticated operations, use the stateless
  credential path in `references/auth-resolution-chain.md`; do not require a
  login session or persist supplied credentials merely to execute a command.
- MCP: select the consumer's transport and load `references/mcp-transports.md`.
  Implement and test the supported protocol. Keep stdio logs off stdout. Load
  `references/oauth-streamable-http.md` for remote authenticated access and
  qualify extensions against SDK/client support. Validate origins and bindings.
- Optional expanded-surface preset: curated workflows, an allowlisted schema
  escape hatch, and sandboxed code mode suit large API catalogs. Select only
  needed tiers and resources/prompts. Load `references/code-mode.md` only for
  bulk/chained execution; schema drift still needs permission and behavior checks.

### 6. Harden

Verify original behavior through each selected adapter: help/discovery, schema
validation, success/failure, mutation boundaries, redaction and headless execution.
`--both` requires both consumer paths plus shared-core checks. Include auth
rejection when auth exists. Run relevant project tests, types, lint and integration
checks; repair in-scope regressions. Add release CI and companion skills only
when requested, using existing workflow and installed skill-creation capability.
Packaging does not itself authorize publication.

### 7. Package

Deliver selected artifacts, usage examples, consumer results, decisions and
limitations. Update the smallest owning documentation. When publication is
requested, verify install/package and deployment receipts; otherwise report
readiness rather than a release.

## Error recovery

No exposable operation: identify the necessary refactor and unresolved decision.
Schema drift: regenerate selected bindings and verify permissions and behavior.
Client mismatch: establish supported protocol/transport pairs before adding
compatibility code. Failed headless credentials: repair resolution without
logging or persisting values.

## Advisory supervision (`--advice`)

When `--advice` is present, run this skill under `kongming` supervision. Load
`../ak-brainstorm/references/advisory-supervision.md` for supervisor identity,
host detection, and model routing.

Spawn `kongming` at these checkpoints: (1) after Scout/Analyze — pass the
Agentization Map and evidence; (2) before the Phase 3 decision record is
finalized — pass mode, capability list, transports, deployment targets; (3)
before the Phase 7 package handoff — pass harden evidence; (4) when stuck —
pass everything tried and the exact obstacle. Invoke with
`delegate_agent capability(subagent_type="kongming", prompt="<task, evidence,
approaches tried, the exact question>", description="advice: <checkpoint>")`.
`--advice` never bypasses this skill's hard gates, tests, review blockers, or
security policy.

## Ultra Verifier Mode (`--ultra`)

When `--ultra` is present, run Phases 0-1 once; the skill then fans only the
Agentization Map and decision record generation (Phases 2-3) across five
parallel read-only candidates. A single strongest-model verifier scores each
complete decision record on fidelity to scouted behavior, agent-centric design
quality, capability selection sharpness, and deployment realism, then selects
the single winning decision record unchanged (or rejects all, hard-stop).
Phases 4-7 execute once from the winner. In `--ask`, the interview runs once
before the fan; candidates never call `ask_user`. Full mechanics:
`../ak-brainstorm/references/ultra-verifier-mode.md`.

## References

- `references/agent-centric-design.md` — Agent-facing invariants and optional expanded-surface preset
- `references/monorepo-layout.md` — Tree, package.json, NPM Trusted Publisher OIDC release CI
- `references/mcp-transports.md` — Transport selection and version-qualified consumer checks
- `references/oauth-streamable-http.md` — OAuth 2.1, CIMD, RFC 9728, RFC 8707, RFC 9207, Cloudflare Zero Trust
- `references/auth-resolution-chain.md` — Resolution chain, stateless `--api-key` guarantee
- `references/deployment-guide.md` — Cloudflare Workers preset, Durable Objects, Docker
- `references/code-mode.md` — Sandboxed code orchestration over MCP tools
- `references/challenge-framework.md` — `--ask` interview prompts
- `../ak-skill-creator/references/cross-marketplace-distribution.md` — Claude, ChatGPT, skills.sh

