uCoz Agent Skills
Agent Skills의 공식 스킬 모음입니다. uCoz에서 랜딩 페이지, 사이트 프로비저닝, 광고 캠페인을 처리하는 AI 에이전트를 위한 스킬입니다.
각 스킬은 ucoz-mcp 서버와 함께 제공됩니다. 플러그인을 한 번 설치하면 지침과 도구를 모두 사용할 수 있습니다.
웹사이트 카탈로그: ucoz.com/ai/skills
MCP 문서: api.ucoz.net/mcp
사용 가능한 스킬
| 스킬 | 설명 | 버전 |
|---|---|---|
| ucoz-landing-skill | MCP를 통해 랜딩 페이지 생성 및 편집 | 1.3 |
| ucoz-provisioning-skill | uCoz 사이트 생성/연결 및 MCP(uAPI, FTP, 모듈) 구성. Playwright 필요 — browser-runner 참조 | 1.1 |
설치
Cursor (스킬 + MCP)
GitHub에서 설치 — 스킬과 MCP가 .cursor-plugin/plugin.json을 통해 함께 구성됩니다.
설정 → 규칙 → 새 규칙 → GitHub에서 추가 → https://github.com/ucoz-skills/agent-skills.git
또는 cursor.directory/plugins/new에서 저장소를 제출하세요.
설치 후, 설정 → 도구 및 MCP를 열고 ucoz-mcp의 환경 변수를 설정하세요(MCP 설정 참조).
Codex (스킬 + MCP)
Codex 앱 — 플러그인 카탈로그에서 uCoz 플러그인을 설치하세요.
Codex CLI — /plugins를 실행하고 uCoz를 선택한 후 플러그인 설치를 선택하세요.
스킬은 skills/에서 로드되며, MCP 구성은 .codex-plugin/plugin.json을 통해 .mcp.json에서 읽어옵니다. Codex MCP 설정에서 uCoz 환경 변수를 설정하세요(MCP 설정 참조).
Antigravity (IDE + CLI)
Google Antigravity는 skills/에서 스킬을 발견하고 네이티브 플러그인(plugin.json + mcp_config.json)을 통해 번들 MCP를 지원합니다.
Antigravity CLI — 플러그인 설치 (권장, 스킬 + MCP):
agy plugin install https://github.com/ucoz-skills/agent-skills.git
전역적으로 ~/.gemini/config/plugins/ucoz/ 아래에 설치됩니다. agy plugin list로 확인하고 CLI에서 /skills로 스킬을 탐색하세요.
Antigravity IDE — Skills CLI:
npx skills add ucoz-skills/agent-skills
스킬 폴더를 ~/.agents/skills/에 설치합니다(Antigravity IDE가 발견). 모든 Antigravity 도구에서 공유하려면 대신 ~/.gemini/skills/에 복사하세요 — Antigravity 스킬 문서 참조.
워크스페이스 전용 설치 — 프로젝트 루트의 .agents/skills/에 스킬 폴더를 복사하세요.
설치 후, MCP에 대한 UCOZ_* 환경 변수를 설정하세요(MCP 설정 참조). 플러그인 경로를 사용하는 경우 MCP는 mcp_config.json에서 번들로 제공됩니다. 그렇지 않으면 해당 파일을 ~/.gemini/config/mcp_config.json에 병합하세요.
설치 전 로컬 클론을 검증하려면:
agy plugin validate /path/to/agent-skills
Hermes (Skills Hub)
Hermes Agent는 GitHub 탭과 skills.sh 인덱스에서 스킬을 발견합니다.
저장소 구독 (커스텀 탭):
hermes skills tap add ucoz-skills/agent-skills
스킬 설치:
hermes skills install ucoz-skills/agent-skills/skills/ucoz-landing-skill
hermes skills install ucoz-skills/agent-skills/skills/ucoz-provisioning-skill
Skills CLI (카탈로그 인덱싱을 위해 skills.sh 원격 측정에 저장소를 등록):
npx skills add ucoz-skills/agent-skills
첫 설치 후, 스킬이 skills.sh/ucoz-skills/agent-skills와 Hermes Skills Hub 인덱스에 나타납니다(주기적으로 새로고침). 업데이트: GitHub에 푸시하면 사용자가 hermes skills check와 hermes skills update를 실행합니다.
Hermes는 탭을 탐색하기 위해 GitHub API를 사용합니다. API 속도 제한이 발생하면
~/.hermes/.env에GITHUB_TOKEN을 설정하거나gh auth login을 실행하세요.
Claude Code (마켓플레이스)
/plugin marketplace add ucoz-skills/agent-skills
/plugin install ucoz@ucoz-skills
스킬은 skills/에서 로드되고, MCP 구성은 플러그인 루트의 .mcp.json에서 읽어옵니다.
Skills CLI (스킬만)
npx skills add ucoz-skills/agent-skills
단일 스킬 설치:
npx skills add ucoz-skills/agent-skills --skill ucoz-landing-skill
npx skills add ucoz-skills/agent-skills --skill ucoz-provisioning-skill
Skills CLI는 지침만 설치합니다. MCP 도구를 사용하려면
.mcp.json을 프로젝트나 IDE에 별도로 추가하세요.
수동 설치
스킬 폴더를 에이전트 스킬 디렉토리에 복사하세요:
skills/ucoz-landing-skillskills/ucoz-provisioning-skill(Playwright 프로비저닝을 위한browser-runner/포함)
| 도구 | 스킬 경로 |
|---|---|
| Cursor | .cursor/skills/ 또는 .agents/skills/ |
| Claude Code | .claude/skills/ |
| Antigravity | .agents/skills/ (워크스페이스) 또는 ~/.gemini/skills/ (전역) |
MCP 설정
저장소에는 .mcp.json이 포함되어 있습니다. Cursor, Codex, Claude Code 또는 Antigravity 플러그인을 설치하면 자동으로 번들됩니다.
MCP는 stdio를 통해 실행됩니다:
npx -y ucoz-mcp@latest
IDE MCP 설정에서 다음 환경 변수를 설정하세요:
| 변수 | 설명 |
|---|---|
UCOZ_API_TOKEN | 제어판의 uAPI 토큰 |
UCOZ_SITE_URL | 사이트 URL (예: https://example.ucoz.net/) |
UCOZ_FTP_HOST | FTP 호스트 |
UCOZ_FTP_USER | FTP 사용자 이름 |
UCOZ_FTP_PASS | FTP 비밀번호 |
예시 MCP 구성 (.mcp.json 및 mcp_config.json에도 포함):
{
"mcpServers": {
"ucoz-mcp": {
"command": "npx",
"args": ["-y", "ucoz-mcp@latest"],
"env": {
"UCOZ_API_TOKEN": "your-token",
"UCOZ_SITE_URL": "https://your-site.ucoz.net/",
"UCOZ_FTP_HOST": "your-site.ucoz.net",
"UCOZ_FTP_USER": "your-ftp-login",
"UCOZ_FTP_PASS": "your-ftp-password"
}
}
}
}
MCP 도구
| 도구 | 용도 |
|---|---|
templates_tool | 페이지 템플릿, 메뉴, 메일 폼, 백업 |
ftp_tool | CSS/JS/이미지 업로드, 사이트 파일 관리 |
modules_tool | 모듈 설치, 격리/인덱싱 |
라이선스
MIT — LICENSE 참조.