Skip to content
Skills Library
AI & agents · Review & audit

menu-proposal

/menu-proposal

Review and recommend the shared native Telegram command menu in interactive sessions. Samples telemetry, inspects capabilities, converts hyphenated skill names to valid snake_case Telegram commands, presents an interactive proposal matrix, and codifies approved updates. Strictly excludes headless worker commands (/pull, /dump) per headless-workers.md. Use when an operator requests a menu review or update. Exclude for headless workers or non-Telegram commands.

Repository
academicops ↗
Licence
MIT
Last repository change
13.11.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 13.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Review and recommend the shared native Telegram command menu in interactive sessions. Samples telemetry, inspects capabilities, converts hyphenated skill names to valid snake_case Telegram commands, presents an interactive proposal matrix, and codifies approved updates. Strictly excludes headless worker commands (/pull, /dump) per headless-workers.md. Use when an operator requests a menu review or update. Exclude for headless workers or non-Telegram commands.

Original author description

Review and recommend the shared native Telegram command menu in interactive sessions. Samples telemetry, inspects capabilities, converts hyphenated skill names to valid snake_case Telegram commands, presents an interactive proposal matrix, and codifies approved updates. Strictly excludes headless worker commands (/pull, /dump) per headless-workers.md. Use when an operator requests a menu review or update. Exclude for headless workers or non-Telegram commands.

How it works

  1. Procedure
Original SKILL.md headings · 50 lines, 462 words
SKILL.md preview
---
name: menu-proposal
description: Review and recommend the shared native Telegram command menu in interactive sessions. Samples telemetry, inspects capabilities, converts hyphenated skill names to valid snake_case Telegram commands, presents an interactive proposal matrix, and codifies approved updates. Strictly excludes headless worker commands (/pull, /dump) per headless-workers.md. Use when an operator requests a menu review or update. Exclude for headless workers or non-Telegram commands.
---

# Menu Proposal Workflow

Review, customize, and allocate the native Telegram command menu for Ida.

## Procedure

### 1. Sample Telemetry and Discover Capabilities

1. **Sample recent invocations:** Query execution telemetry spans (or inspect recent session logs) for skill runs and menu taps across interactive sessions and subagents to gather empirical invocation frequencies.
2. **Discover candidate skills and workflows:**
   - Enumerate installed skills across plugins (`plugins/*/skills/`) and common workflow templates.
   - Include operator-facing coordination skills (`reify`, `dispatch`, `reconcile`, `daily`).
   - Strictly exclude reserved platform commands (`start`, `help`, `status`) and headless worker lifecycle commands (`pull`, `dump`).
3. **Separate interactive menus from headless workers (`headless-workers.md`):**
   - Telegram command menus exclusively serve interactive operator sessions. Headless worker lifecycle commands (`pull`, `dump`) must never appear on conversational menus or in candidate pools.
   - Telegram command menus serve interactive operator dialogue; do not dispatch this workflow to headless workers.
4. **Inspect current allocations:** Read the active `TELEGRAM_BOT_COMMANDS` list in the channel's `$STATE_DIR/.env`.

### 2. Synthesize Considered Recommendations

Apply qualitative judgment to evaluate candidate commands for the shared menu:

- **Shared Menu Allocation:** Prioritize high-frequency operational triage, quick capture, decision walk-throughs, task queueing, disambiguation, daily briefings, and worker dispatch (e.g. `/decide`, `/q`, `/reconcile`, `/hydrate`, `/up`, `/reify`, `/dispatch`, `/daily`).
- **Composite commands:** Propose single-tap composite commands where recurring multi-step patterns or common briefings are identified (such as `/daily`).
- **Command identifier normalization & platform constraints:**
  - Convert kebab-case skill and workflow names to valid Telegram command identifiers (`snake_case`) by replacing hyphens with underscores (e.g. `strategic-review` $\rightarrow$ `/strategic_review`, `argument-map` $\rightarrow$ `/argument_map`, `menu-proposal` $\rightarrow$ `/menu_proposal`, `session-trace` $\rightarrow$ `/session_trace`).
  - Ensure all command identifiers strictly match `/^[a-z0-9_]{1,32}$/` (no hyphens, lowercase alphanumeric and underscores only, length 1–32).
  - Descriptions must be 1–256 characters, and total registered commands must not exceed 100.

### 3. Present Proposal Matrix

Present a scannable proposal table to the user in interactive operator sessions:

- **Candidate pool summary:** Total candidates inspected and current allocations in the shared menu.
- **Recommendation table:**
  - `Command`: Normalized identifier matching `/^[a-z0-9_]{1,32}$/` with hyphens converted to underscores (e.g. `/reify`, `/strategic_review`).
  - `Type`: `skill`, `workflow`, or `composite`.
  - `Usage`: Empirical invocation count from recent telemetry.
  - `Proposed Inclusion`: `[Include]`, `[Exclude]`, or `[Optional]`.
  - `Description`: Clear functional summary.
  - `Rationale`: Why this command fits the shared menu.
- **Interactive options:** Present checkbox proposals or structured options allowing the user to approve recommendations or adjust allocations in free text.

### 4. Codify Approved Allocations

1. The menu is exactly the JSON list in `TELEGRAM_BOT_COMMANDS`; the plugin builds none of its own. Codify the approved command list as JSON into `TELEGRAM_BOT_COMMANDS` in the channel's environment configuration (`$STATE_DIR/.env`); it is registered at the next poller start.
2. Run test verification (`cd plugins/ida-telegram && bun test test/commands.test.ts`) to ensure command registration passes cleanly.
3. Confirm updated menu to the user.

Versions

The database has no other skills named menu-proposal.

Database snapshot: 13.11.2026 · package version 300b10f0f8ac (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100squad-commands
    Categorized catalog of common Squad operations. Coordinator reads this file and presents it as an interactive menu when the user asks for available commands or help.
  • 100squad-commands
    Categorized catalog of common Squad operations. Coordinator reads this file and presents it as an interactive menu when the user asks for available commands or help.
  • 100telegram
    Format, structure, and interaction rules for communicating with the user over Telegram. Use when a Telegram channel is attached or when processing Telegram messages, reactions, or commands. Not for other channels or for general content composition.
  • 100skill-cron
    Use when the user wants to register, inspect, manually run, or remove scheduled Claude skills with Telegram push notifications. Presents a menu, discovers schedulable skills with headless-prompt frontmatter, converts natural-language schedules into cron entries with conflict…
  • 86telegram-connect
    Set up Telegram as a notification center for your Egregore — creates the group, links the bot, and stores the chat ID. Use for /telegram-connect, ''connect telegram'', or ''set up telegram notifications''.
  • 100customize
    Add new capabilities or modify MatClaw behavior. Use when user wants to add channels (Telegram, Slack, email input), change triggers, add integrations, modify the router, or make any other customizations. This is an interactive skill that asks questions to understand what the user wants.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.