operator-setup

Authenticate Operator Editor MCP access by reading .operator files and updating OPERATOR_SESSION_ID.

Updated Oct 8, 2025
One-click install
npx skills add https://github.com/ichabodcole/project-docs-scaffold-template --skill operator-setup
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: operator-setup
Source: https://github.com/ichabodcole/project-docs-scaffold-template/tree/main/plugins/operator/skills/operator-setup
Command: npx skills add https://github.com/ichabodcole/project-docs-scaffold-template --skill operator-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Operator Setup helps users configure and authenticate Operator Editor MCP access, enabling secure session management for editing and syncing documents.

Core Features & Use Cases

  • Detects missing or expired Operator sessions and guides first-time setup.
  • Reuses existing MCP sessions within a 24-hour window to minimize re-authentication.
  • Provides clear instructions for creating and persisting credentials via a .operator file.

Quick Start

Create or update a .operator file with your credentials to start an authenticated Operator MCP session.

Frequently Asked Questions about operator-setup

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

FAQPage Schema
How do I authenticate Operator Editor MCP access for secure document editing?▼

To authenticate Operator Editor MCP access, you apply the operator-setup process during first-time setup, which validates your session via OPERATOR_API_KEY and updates the OPERATOR_SESSION_ID for secure document editing.

What is an Operator MCP session and when do I need to re-authenticate?▼

An Operator MCP session enables secure document editing and syncing. You need to re-authenticate when your session is missing, expired, or outside the 24-hour reuse window across projects.

How do I configure a .operator file for MCP session setup?▼

You configure a .operator file by creating or updating it with your credentials, specifically the OPERATOR_API_KEY, to start an authenticated Operator MCP session and persist your access.

Can I reuse an existing MCP session across multiple projects?▼

Yes, you can reuse existing MCP sessions across projects within a 24-hour window to minimize re-authentication, provided the session remains valid and has not expired.

Why does my Operator MCP setup fail to validate my session?▼

Operator MCP setup fails to validate your session if the .operator file is missing credentials, the OPERATOR_API_KEY is invalid, or the OPERATOR_SESSION_ID has expired outside the 24-hour window.