connect

Synchronize local Agentic30 state and pending events via MCP.

1|Updated Feb 20, 2026
One-click install
npx skills add https://github.com/october-academy/agnt --skill connect-october-academy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: connect
Source: https://github.com/october-academy/agnt/tree/main/skills/connect
Command: npx skills add https://github.com/october-academy/agnt --skill connect-october-academy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensure a user's local Agentic30 progress and offline quest submissions are securely linked and synchronized with the Agentic30 backend, preventing lost XP and keeping dashboards up to date. The Skill handles account sign-up guidance, MCP OAuth authentication, environment detection for where local state is stored, and robust flushing of pending events.

Core Features & Use Cases

  • Environment detection: Locates AGNT_DIR by probing common Claude and Codex paths and reads state.json.
  • State validation: Verifies state.json parses and matches schema_version 3 and instructs re-running onboarding if invalid.
  • Account & MCP flow: Guides users through web signup, MCP authentication for Claude Code or Codex, and transitions identity.mode through guest → registered → synced.
  • Pending events flush: Sequentially submits submit_practice events via MCP, preserves failed events, updates sync metadata, and optionally backs up local state to the server.
  • User guidance & recovery: Emits clear, Korean user-facing messages and fallback instructions when authentication or tool availability fails.

Quick Start

Connect my Agentic30 account, complete the MCP authentication flow for my environment, and synchronize all pending quest events from my local state.

Frequently Asked Questions about connect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync local Agentic30 quest progress to the MCP backend?

Sync local Agentic30 progress by authenticating via MCP OAuth, which flushes pending submit_practice events from your state.json to the backend, preventing lost XP and updating your dashboard.

Do I need a registered Agentic30 account before connecting Claude Code or Codex CLI?

Yes, you need a registered account. The Skill guides web signup and transitions identity.mode from guest to registered before performing MCP OAuth authentication for Claude Code or Codex CLI.

What happens if my state.json schema version is invalid during Agentic30 synchronization?

If your state.json schema is invalid, the Skill detects that schema_version 3 validation fails and instructs you to re-run onboarding. It preserves failed pending events and provides fallback recovery instructions.

Can I use the Agentic30 MCP authentication flow with both Claude Code and Codex CLI environments?

Yes, the Agentic30 MCP authentication flow supports both Claude Code and Codex CLI. The Skill performs environment detection by probing common paths to locate AGNT_DIR and applies the correct OAuth flow for your setup.

Why did my offline quest completions fail to flush to the Agentic30 MCP?

Offline quest completions fail to flush when authentication or MCP tool availability fails. The Skill sequentially submits submit_practice events, preserves failed events locally, and emits clear user-facing recovery instructions to resolve the issue.