tool-section-page

Builds and repairs documentation-site tool sections with verified screenshots, links, and one-viewport layouts.

Updated Aug 6, 2021
One-click install
npx skills add https://github.com/the-homeless-god/dotfiles --skill tool-section-page-the-homeless-god
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tool-section-page
Source: https://github.com/the-homeless-god/dotfiles/tree/main/skills/tool-section-page
Command: npx skills add https://github.com/the-homeless-god/dotfiles --skill tool-section-page-the-homeless-god

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Tool sections on documentation sites often ship broken: they open with prose instead of a working demo, make claims the tool no longer keeps, contain stale screenshots, have tab links that all open the same panel, or sprawl across dozens of viewports. This Skill provides six enforceable rules to build or repair a tool's section so it shows the tool working first and never lies about what the tool does. ## Core Features & Use Cases - Demo-first structure: Enforces a tab layout where the "In action" panel opens by default, with the value proposition visible in the page header on every panel. - Truth verification: Requires every claim to match the tool's current behavior, with numbers pulled from the tool's own measured state rather than typed into templates. - Measured one-viewport rule: Mandates scrollHeight checks at 1280x800 and 390x844 for both language editions, with before/after numbers in the commit message. - Scripted screenshots: Frames are captured by a committed script running the tagged release, with text output kept beside each frame for search and accessibility. - Use Case: A Hugo documentation site has a tool page whose screenshots are a year old and whose tab links all open the first panel. Apply this Skill to re-shoot frames from the released build, fix the tab-addressing contract, and verify every panel link in a browser. ## Quick Start Use the tool-section-page skill to audit and rebuild the documentation section for my CLI tool so it opens with a real demo and fits one viewport.

Frequently Asked Questions about tool-section-page

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure a documentation page for a CLI tool?

Open with the tool working: put an "In action" tab with real captured frames as the default panel, followed by "What it is", "Getting started", and "Limits". Keep the reason to use the tool in the page header so it is visible on every panel.

How to keep documentation screenshots from going stale?

Capture frames with a committed script that runs the tagged release and renders output from a data file, never by hand. Re-shoot whenever a release changes behavior, and print the version and commit under each frame.

Why do all my tab links open the same panel?

This happens when the tabs module is initialized without reading the URL hash. The server should print plain anchor links with no hidden attributes, and the module should assign roles and update the address only via replaceState.

How do I verify a documentation page fits one viewport?

Measure documentElement.scrollHeight against clientHeight at 1280x800 and 390x844 for every language edition, before and after changes. Panels may scroll internally, but the document itself must not.

When should I not use this tool-section-page approach?

Do not apply these rules to course chapters, blog posts, or reference documentation, which are prose by design. The six rules target a tool's own promotional-demonstration section, not long-form written content.