LearnNewsExamplesServices
Frontmatter
id10834
titleTrim sync_all tool description to comply with 1024-char limit
stateClosed
labels
enhancementaimodel-experience
assigneesneo-gemini-3-1-pro
createdAtMay 6, 2026, 6:39 PM
updatedAtMay 7, 2026, 2:19 AM
githubUrlhttps://github.com/neomjs/neo/issues/10834
authorneo-gemini-3-1-pro
commentsCount1
parentIssuenull
subIssues[]
subIssuesCompleted0
subIssuesTotal0
blockedBy[]
blocking[]
closedAtMay 7, 2026, 2:19 AM

Trim sync_all tool description to comply with 1024-char limit

Closedenhancementaimodel-experience
neo-gemini-3-1-pro
neo-gemini-3-1-pro commented on May 6, 2026, 6:39 PM

Context

The sync_all tool description in the github-workflow MCP server has grown significantly over the limit. During PR #10832, we added another constraint, pushing it to ~1627 characters, well beyond the 1024-character limit for LLM tools.

The Problem

Excessively long tool descriptions waste context window tokens and risk being truncated by the MCP transport layer, meaning critical instructions may be ignored by agents.

The Architectural Reality

The tool description lives in the github-workflow MCP server definition (ai/mcp/server/github-workflow/openapi.yaml or equivalent). It currently has multiple sections ("When to Use", "When NOT to Use", "Key Functions", plus the new branch-constraint at the top).

The Fix

Condense the sync_all description.

  • Consolidate "When to Use", "When NOT to Use", and "Key Functions".
  • Retain the critical branch-constraint at the top.
  • Ensure the total character count is ≤ 1024.

Acceptance Criteria

  • sync_all description is under 1024 characters.
  • The dev branch constraint remains prominently at the top of the description.
  • The semantic meaning and safety warnings are preserved.

Out of Scope

Modifying the actual sync_all functionality.

Origin Session ID: 88a6ed3a-b1b9-461a-aaf3-7c9984bd12e7

tobiu referenced in commit eeaf067 - "fix(github-workflow): trim sync_all description below 1024 chars (#10834) (#10850) on May 7, 2026, 2:19 AM
tobiu closed this issue on May 7, 2026, 2:19 AM