Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

No length cap on a synced skill's name/description

Open
#1,223 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
48/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Active
Tech stack
typescript
Domain
ai, cli

Research direction

Trace how synced SKILL.md frontmatter reaches Skill.fmt and the Skill tool description, then inspect the existing MAX_TOTAL_BYTES and MAX_TOTAL_FILES handling. Measure real skill sizes before deciding an appropriate per-field limit and failure behavior. Done when oversized name and description fields are bounded without silently damaging legitimate skills, with coverage for the chosen behavior.

Written by the indexing model from the issue text.

Description

Deferred from the v0.10.0 release review.

A synced bundle is bounded by MAX_TOTAL_BYTES (32MB) and MAX_TOTAL_FILES (2000), but no limit applies to a single SKILL.md frontmatter field. A name or description can be arbitrarily large within that budget.

Both fields are echoed into the system prompt (Skill.fmt) and into the Skill tool's description, on every turn — so one oversized field inflates every request for the life of the session.

Not fixed in the release PR because the cap has to be chosen against real skill sizes: too tight and it silently truncates legitimate descriptions, which is its own failure.

Dominant language
TypeScript
Stars
813
Forks
134
Avg merge
2d 8m
Merged PRs (30d)
65

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from AltimateAI/altimate-code

All issues in AltimateAI/altimate-code

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.