[harlan-zw]

🔗 Linked issue

Related to Skit #52.

❓ Type of change

• 📖 Documentation
• 🐞 Bug fix
• 👌 Enhancement
• ✨ New feature
• 🧹 Chore
• ⚠️ Breaking change

📚 Description

Skill pages show token estimates without explaining metadata defects or Agent listing limits.
Show a compact description-size warning beside token usage. Expand it for the reason, metadata checks, and description limits.

Explain that Skills share space for their names and descriptions. Label the 1% threshold as a size suggestion.

The Claude comparison labels its 200k-context example and versioned source.
It accounts for when_to_use and disable-model-invocation without assuming the visitor's local settings.

🤖 AI disclosure: Harlan Agent Kit modified this description. My AI open-source policy.

[harlan-zw]

🤖 Agent browser check: the running Skill page shows context warnings beside token usage at desktop and 390px widths.
The mobile page has no horizontal overflow. The comparison labels the example allowance and source versions.

[harlan-zw]

🤖 Agent browser check: context warnings now use one collapsed row below token usage.
Enter and click expand the warning, estimate, and source limits.
Checked the built page at desktop and 390px widths. No horizontal overflow.

[harlan-zw]

🤖 Agent copy and browser check using Brundlefly's im-not-a-fly Skill.

The old text used “listing allowance” without explaining shared space.
The rewrite explains what the Agent reads and why shorter descriptions help.
It labels 1% as a size suggestion. Example settings and sources expand separately.

Checked the built page at 390px. Both expansions work. No horizontal overflow.