Agent Kit Documentation

Agent Kit adalah platform katalog dan distribusi komponen untuk berbagai ekosistem AI Coding Agent (OpenClaw, Claude Code, Cursor, Windsurf, OpenCode, Codex, GitHub Copilot, dsb).

Intelligent Auto-Detection

Script installer dirancang untuk mendeteksi agent yang aktif di folder proyek secara instan. Anda tidak perlu memikirkan struktur folder masing-masing agent; script akan menaruh skill, command, mcp, atau rules ke path resmi masing-masing tools.

# Cara Install Komponen

Pilih salah satu metode instalasi di bawah ini:

1. Terminal Direct (Bash / Curl) Rekomendasi

Jalankan di root direktori proyek Anda:

curl -sL https://agentkit.jagoankode.site/i/:type/:category/:name | bash

2. NPX CLI Runner Node.js

Jika Anda lebih menyukai Node runtime:

npx https://agentkit.jagoankode.site/cli.js add :type/:category/:name

# Standar Path & 12 Supported Agents

Berikut mapping path resmi yang diterapkan saat proses instalasi:

Agent	File / Indicator Deteksi	Skills Destination Path
OpenClaw	openclaw.json, ~/.openclaw	skills/<name>/SKILL.md
Claude Code	.claude/, .claude.json, claude CLI	.claude/commands/<name>.md
Cursor IDE	.cursor/, .cursorrules	.cursor/rules/<name>.mdc
GitHub Copilot	.github/copilot-instructions.md	.github/instructions/<name>.instruction.md
OpenCode	.opencode/, opencode.json	.opencode/skills/<name>/SKILL.md
Antigravity	.antigravity/, antigravity.json	.antigravity/skills/<name>/SKILL.md
Codex CLI	.codex/, codex.json, codex CLI	.codex/skills/<name>/SKILL.md
DeepSeek Harness	.deepseek/, deepseek.json, .harness/	.deepseek/skills/<name>/SKILL.md
Hermes Agent	.hermes/, hermes.json	.hermes/skills/<name>/SKILL.md
Kiro	.kiro/, kiro.json	.kiro/skills/<name>/SKILL.md
Windsurf	.windsurf/, .codeium/	.windsurf/rules/<name>.md
Aider	.aider.conf.yml, aider CLI	.aider/<name>.conventions.md

# Admin REST API (CRUD)

REST API resmi untuk menambah, memperbarui, membaca, dan menghapus komponen katalog serta file markdown terkait di backend.

Direct File Uploader (.md / .json)

Local to Catalog

Generate file markdown skill di lokal, lalu upload langsung ke server melalui form di bawah ini. File langsung disimpan di disk server dan terdaftar di live catalog.

Component Type *

Category *

Custom Name / Slug (Opsional)

Display Title (Opsional)

Description (Opsional)

Admin API Key *

Upload File Markdown (.md) atau JSON (.json) *

Klik atau drag file .md / .json ke sini

1. Authentication

Wajib

Semua endpoint diawali dengan /api/admin/* dan membutuhkan otentikasi API Key:

Opsi 1: HTTP Header (Recommended) X-API-KEY: agentkit-secret-key-2026

Opsi 2: Query Parameter ?api_key=agentkit-secret-key-2026

* Default key: agentkit-secret-key-2026 (dapat diubah melalui environment variable ADMIN_API_KEY).

POST /api/admin/upload

Multipart Upload

Upload file markdown (.md) atau file JSON (.json) langsung dari terminal atau script lokal Anda.

Form-Data Fields (multipart/form-data)

Field	Type	Required	Description
file	File	Yes	File `.md` atau `.json`
type	string	Yes (for .md)	`skills`, `agents`, `commands`, dll
category	string	Yes (for .md)	Kategori (mis. `development`, `devops`)
name	string	No	Slug unik (default otomatis dari nama file)
title	string	No	Judul display UI
description	string	No	Deskripsi singkat

Example: Upload Local Markdown File via Terminal

curl -X POST "https://agentkit.jagoankode.site/api/admin/upload" \
  -H "X-API-KEY: agentkit-secret-key-2026" \
  -F "file=@./my-local-skill.md" \
  -F "type=skills" \
  -F "category=development" \
  -F "description=Local generated skill"

Response (201 Created)

{
  "success": true,
  "message": "Markdown file uploaded and registered successfully",
  "component": {
    "name": "my-local-skill",
    "title": "my-local-skill",
    "type": "skills",
    "category": "development",
    "description": "Local generated skill",
    "updatedAt": "2026-11-14T02:30:00.000Z"
  }
}

GET /api/admin/components

List Components

Mengambil daftar seluruh komponen yang terdaftar dalam katalog.

Optional Query Parameters

Param	Type	Description
type	string	Filter by type: `skills`, `agents`, `commands`, `mcps`, `hooks`, `settings`
category	string	Filter by category (mis. `development`, `search`, dll)

Example Request

curl -X GET "https://agentkit.jagoankode.site/api/admin/components?type=skills" \
  -H "X-API-KEY: agentkit-secret-key-2026"

Response (200 OK)

{
  "success": true,
  "count": 1,
  "data": [
    {
      "name": "supermemory",
      "title": "Supermemory Integration",
      "description": "Integrasi memori persistent OpenClaw dengan self-hosted Supermemory.",
      "type": "skills",
      "category": "memory",
      "author": "OpenClaw Team",
      "tags": ["memory", "openclaw", "knowledge-graph"],
      "updatedAt": "2026-11-14T02:05:00.000Z"
    }
  ]
}

GET /api/admin/components/:type/:category/:name

Get Single & Content

Mengambil detail metadata spesifik komponen beserta raw markdown content fisiknya.

Example Request

curl -X GET "https://agentkit.jagoankode.site/api/admin/components/skills/memory/supermemory" \
  -H "X-API-KEY: agentkit-secret-key-2026"

Response (200 OK)

{
  "success": true,
  "data": {
    "name": "supermemory",
    "title": "Supermemory Integration",
    "description": "Integrasi memori persistent OpenClaw dengan self-hosted Supermemory.",
    "type": "skills",
    "category": "memory",
    "author": "OpenClaw Team",
    "tags": ["memory", "knowledge-graph"],
    "content": "# Supermemory Skill\n\nPanduan integrasi persistent memory..."
  }
}

POST /api/admin/components

Create Component

Mendaftarkan komponen baru ke katalog serta secara otomatis menyimpan file markdown di direktori content/:type/:category/:name.md.

Request Body Schema (application/json)

Field	Type	Required	Description
name	string	Yes	Slug unik komponen (contoh: `git-workflow`)
type	string	Yes	`skills` \| `agents` \| `commands` \| `mcps` \| `hooks` \| `settings`
category	string	Yes	Kategori (contoh: `development`, `automation`)
title	string	No	Judul ramah tampilan UI (default: nama slug)
description	string	No	Ringkasan singkat kegunaan komponen
author	string	No	Nama pembuat/maintainer (default: `Community`)
tags	array	No	Tag pencarian (contoh: `["git", "branching"]`)
content	string	Yes	Isi teks prompt / rule / markdown skill

Example Request

curl -X POST "https://agentkit.jagoankode.site/api/admin/components" \
  -H "X-API-KEY: agentkit-secret-key-2026" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "git-workflow",
    "title": "Git Workflow Pro",
    "description": "Standardized git commit and branching conventions.",
    "type": "skills",
    "category": "development",
    "author": "JagoanKode",
    "tags": ["git", "workflow"],
    "content": "# Git Workflow Pro\n\nAlways use Conventional Commits."
  }'

Response (201 Created)

{
  "success": true,
  "message": "Component created successfully",
  "data": {
    "name": "git-workflow",
    "title": "Git Workflow Pro",
    "type": "skills",
    "category": "development",
    "filePath": "/home/ubuntu/apps/aitmpl-browse/content/skills/development/git-workflow.md"
  }
}

PUT /api/admin/components/:type/:category/:name

Update Component

Memperbarui metadata katalog dan/atau mengganti isi file markdown komponen yang telah ada.

Example Request

curl -X PUT "https://agentkit.jagoankode.site/api/admin/components/skills/development/git-workflow" \
  -H "X-API-KEY: agentkit-secret-key-2026" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Updated description with semantic versioning steps.",
    "content": "# Git Workflow Pro v2\n\nUpdated rules..."
  }'

Response (200 OK)

{
  "success": true,
  "message": "Component updated successfully",
  "data": {
    "name": "git-workflow",
    "type": "skills",
    "category": "development",
    "updatedAt": "2026-11-14T02:20:00.000Z"
  }
}

DELETE /api/admin/components/:type/:category/:name

Delete Component

Menghapus komponen dari katalog catalog.json sekaligus menghapus file markdown fisik dari disk server.

Example Request

curl -X DELETE "https://agentkit.jagoankode.site/api/admin/components/skills/development/git-workflow" \
  -H "X-API-KEY: agentkit-secret-key-2026"

Response (200 OK)

{
  "success": true,
  "message": "Component deleted successfully",
  "data": {
    "name": "git-workflow",
    "type": "skills",
    "category": "development"
  }
}

HTTP Status Codes Reference

Code	Meaning	Description
200	OK	Request berhasil (GET, PUT, DELETE).
201	Created	Komponen baru berhasil dibuat dan disimpan ke disk.
400	Bad Request	Parameter atau field wajib (name, type, category, content) tidak lengkap.
401	Unauthorized	API Key salah atau tidak disertakan pada header/query.
404	Not Found	Komponen dengan tipe, kategori, atau nama tersebut tidak ditemukan.
409	Conflict	Komponen dengan nama/kategori tersebut sudah ada saat POST.