# Agent Meeting Skill

Adopt this skill: https://proskills.md/skills/other/agent-meeting-skill

Page: https://proskills.md/skills/other/agent-meeting-skill
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: .github
upstream: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/.github

Content is not inlined in the catalog. Read the upstream file: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/.github

## File: .gitignore
upstream: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/.gitignore

Content is not inlined in the catalog. Read the upstream file: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/.gitignore

## File: README.md
upstream: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/README.md

````text
# Agent Meeting Skill

**Fully isolated, API-configurable meeting skill for OpenClaw agents**

Join meetings, transcribe with speaker identification, and save notes automatically.

## Design Principles

| Principle | Description |
|-----------|-------------|
| 🔌 **Isolated** | No hardcoded paths or agent-specific code |
| 🌐 **API-First** | All configuration via REST API |
| 📦 **Portable** | Install on any OpenClaw agent |
| 🎨 **UI-Ready** | JSON Schema for form generation |

## Quick Start

```bash
# Install
git clone https://github.com/Diomede81/agent-meeting-skill.git
cd agent-meeting-skill
npm install

# 1. Store Recall.ai API key (credentials managed by token-manager-skill)
echo "your-recall-api-key" > ~/.secrets/recall-api-key.txt
chmod 600 ~/.secrets/recall-api-key.txt

# 2. Register in token-manager
curl -X POST http://localhost:3021/api/tokens \
  -H "Content-Type: application/json" \
  -d '{
    "service": "Recall.ai",
    "name": "API Key",
    "category": "api",
    "locationType": "file",
    "location": "~/.secrets/recall-api-key.txt"
  }'

# 3. Start API server
npm start
# → http://localhost:3030

# 4. Configure skill
curl -X PUT http://localhost:3030/api/config \
  -H "Content-Type: application/json" \
  -d '{
    "bot": {"name": "Max"},
    "calendar": {"source": "api", "endpoint": "http://localhost:3007/api/calendar", "agent": "luca"}
  }'

# 5. Verify tokens are configured
curl http://localhost:3030/api/tokens/verify
```

## API Reference

### Configuration

```bash
# Get current config
GET /api/config

# Update config
PUT /api/config
Content-Type: application/json
{"bot": {"name": "Max"}, ...}

# Get JSON Schema (for UI forms)
GET /api/config/schema

# Validate config without saving
POST /api/config/validate
Content-Type: application/json
{"bot": {"name": "Max"}, ...}
```

### Tokens (via token-manager-skill)

```bash
# Check required tokens status
GET /api/tokens

# Verify all required tokens are configured
GET /api/tokens/verify

# Test a specific token
POST /api/tokens/test/Recall.ai
```

**Note:** Credentials are managed by `token-manager-skill` (port 3021), not stored locally.

### Calendar

```bash
# Get upcoming meetings
GET /api/calendar/upcoming

# Test calendar connection
POST /api/calendar/test
```

### Meetings

```bash
# List saved transcripts
GET /api/meetings

# Get specific transcript
GET /api/meetings/2026-03-20_weekly-standup

# Get active meeting status
GET /api/meetings/active

# Join meeting manually
POST /api/meetings/join
Content-Type: application/json
{"url": "https://teams.microsoft.com/l/meetup-join/..."}

# Leave current meeting
POST /api/meetings/leave

# Live transcript (Server-Sent Events)
GET /api/transcript/live
```

### Status

```bash
# Health check
GET /api/status
```

## UI Integration

The skill is designed for any UI to configure it:

```javascript
// 1. Fetch schema
const schema = await fetch('/api/config/schema').then(r => r.json());

// 2. Generate form from JSON Schema
// (use react-jsonschema-form, ajv, or similar)

// 3. Save configuration
await fetch('/api/config', {
  method: 'PUT',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify(formData)
});
```

## Configuration Options

### Calendar Configuration

```json
{
  "calendar": {
    "source": "api",
    "endpoint": "http://localhost:3007/api/calendar",
    "agent": "luca",
    "joinWindowMinutes": 5
  }
}
```

| Option | Type | Default | Description |
|--------|------|---------|-------------|
| `source` | string | `"api"` | Calendar source (`api`, `microsoft`, `google`, `ical`) |
| `endpoint` | string | required | Calendar API endpoint URL |
| `agent` | string | required | Agent identifier for calendar API |
| `joinWindowMinutes` | number | `5` | Time window for joining meetings |

### Join Window Behavior

The skill will **only** attempt to join meetings where the start time falls within the configured join window:

- **Default window:** 5 minutes before to 5 minutes after the meeting start time
- **Example:** For a meeting starting at 10:00 AM:
  - ✅ Will join between 9:55 AM and 10:05 AM
  - ❌ Will NOT join at 9:50 AM (too early)
  - ❌ Will NOT join at 10:10 AM (too late)

**Why this matters:** Prevents the bot from trying to join meetings hours after they've started or long after they've ended.

**Adjusting the window:**
```json
{
  "calendar": {
    "joinWindowMinutes": 10  // Wider window: 10 minutes before/after
  }
}
```

## Architecture

```
┌─────────────────────────────────────────────────────────────┐
│                      UI / Mission Control                    │
└─────────────────────────────┬───────────────────────────────┘
                              │ HTTP/REST
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                    Agent Meeting Skill API                   │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐    │
│  │  Config  │  │ Calendar │  │ Meetings │  │ Credentials│   │
│  │  Manager │  │  Client  │  │   Bot    │  │   Store   │    │
│  └──────────┘  └──────────┘  └──────────┘  └──────────┘    │
└─────────────────────────────┬───────────────────────────────┘
                              │
        ┌─────────────────────┼─────────────────────┐
        ▼                     ▼                     ▼
┌──────────────┐    ┌──────────────┐    ┌──────────────┐
│ Calendar API │    │  Recall.ai   │    │   Storage    │
│ (Middleware) │    │ (Meeting Bot)│    │  (data/*.md) │
└──────────────┘    └──────────────┘    └──────────────┘
```

## Data Storage

All data stored within skill directory (portable):

```
data/
├── config.json       # User configuration
├── credentials.enc   # Encrypted credentials
├── state.json        # Runtime state
└── meetings/         # Saved transcripts
    ├── 2026-03-20_weekly-standup.md
    └── 2026-03-21_project-review.md
```

## Transcript Format

```markdown
# Meeting: Weekly Standup

**Date:** 2026-03-20 10:00 AM  
**Duration:** 45 minutes  
**Platform:** Microsoft Teams  
**Attendees:** Luca, Masum, Austin

---

## Transcript

**Luca (10:00:15):** Good morning everyone, let's get started.

**Masum (10:00:22):** Morning! I'll go first with the Empathika update...

---

## Summary

- Empathika v2.3 release scheduled for next week
- Action item: Masum to finalize API documentation
- Next standup: Thursday 10 AM

---

*Transcribed by Max*
```

## Required Tokens (via token-manager)

| Service | Location | Required | Description |
|---------|----------|----------|-------------|
| `Recall.ai` | `~/.secrets/recall-api-key.txt` | Yes | Meeting bot API |

Register tokens via token-manager-skill (port 3021) before using this skill.

## Environment Variables

| Variable | Default | Description |
|----------|---------|-------------|
| `PORT` | 3030 | API server port |
| `DATA_DIR` | `./data` | Override data directory |
| `TOKEN_MANAGER_URL` | `http://localhost:3021` | Token manager API URL |
| `SECRETS_DIR` | `~/.secrets` | Override secrets directory |

## License

MIT
````

## File: SETUP.md
upstream: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/SETUP.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/SETUP.md

## File: SKILL.md
upstream: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/SKILL.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/SKILL.md

## File: ci.yml
upstream: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/ci.yml

Content is not inlined in the catalog. Read the upstream file: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/ci.yml

## File: config
upstream: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/config

Content is not inlined in the catalog. Read the upstream file: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/config

## File: docs
upstream: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/docs

Content is not inlined in the catalog. Read the upstream file: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/docs

## File: jest.config.js
upstream: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/jest.config.js

Content is not inlined in the catalog. Read the upstream file: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/jest.config.js

## File: lib
upstream: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/lib

Content is not inlined in the catalog. Read the upstream file: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/lib

## File: package-lock.json
upstream: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/package-lock.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/package-lock.json

## File: package.json
upstream: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/package.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/package.json

## File: scripts
upstream: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/scripts

Content is not inlined in the catalog. Read the upstream file: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/scripts

## File: service
upstream: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/service

Content is not inlined in the catalog. Read the upstream file: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/service

## File: templates
upstream: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/templates

Content is not inlined in the catalog. Read the upstream file: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/templates

## File: tests
upstream: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/tests

Content is not inlined in the catalog. Read the upstream file: https://github.com/diomede81/agent-meeting-skill/blob/HEAD/tests