Agent skill

Progressive Disclosure Defaults And Tucking

by hashgraph-online in hashgraph-online/awesome-codex-plugins

A skill your agent uses when deciding what to surface and what to tuck — the editorial choices behind progressive disclosure.

Apache-2.0Auto-check passed

Install Progressive Disclosure Defaults And Tucking

skills CLI
$ npx skills add hashgraph-online/awesome-codex-plugins --skill progressive-disclosure-defaults-and-tucking -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins progressive-disclosure-defaults-and-tucking --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/HDeibler/universal-design-principles/plugins/cognition-and-learnability-principles/skills/progressive-disclosure-defaults-and-tucking .claude/skills/progressive-disclosure-defaults-and-tucking && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
progressive-disclosure-defaults-and-tucking
GitHub stars
1.3k
Token cost
~2.2k tokens
SKILL.md length
1,051 words
Files
2 (incl. references)
Skills in repo
716
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when deciding what to surface and what to tuck — the editorial choices behind progressive disclosure.

  • Works in 3 steps: Who is it for? → When is it needed? → How often is it used?
  • Deciding what to surface and what to tuck — the editorial choices behind progressive disclosure
  • SKILL.md covers The framework: who, when, how…, Defaulting disclosure state, What earns primary placement and What earns tucking, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Progressive Disclosure Defaults And Tucking is an agent skill from hashgraph-online/awesome-codex-plugins. Use this skill when deciding what to surface and what to tuck — the editorial choices behind progressive disclosure. Trigger when laying out a settings page, picking which form fields to show by default, deciding whether a section starts collapsed or open, or arguing about whether a feature deserves primary chrome or belongs in "Advanced." Sub-aspect of progressive-disclosure; read that first.

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/editorial-method.md`).

The repository describes itself as: A curated list of awesome OpenAI Codex / ChatGPT plugins, skills, and resources. The 1 Codex Marketplace. See live plugins at: https://hol.org/plugins/best-codex-plugins. The licence is Apache-2.0.

When your agent uses it

  • Deciding what to surface and what to tuck — the editorial choices behind progressive disclosure
  • Laying out a settings page
  • Picking which form fields to show by default
  • Deciding whether a section starts collapsed

Example prompts

  • “Advanced.”
  • “/progressive-disclosure-defaults-and-tucking”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Who is it for?
  2. When is it needed?
  3. How often is it used?

What it can do on your machine

Read from SKILL.md and the folder at commit 3e1456a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are javascript).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Progressive Disclosure Defaults And Tucking loads about 2.2k tokens when it runs, and up to ~3.5k if it reads all its reference files. Until then it costs about 112 tokens; SKILL.md has 1,051 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~112
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from hashgraph-online/awesome-codex-plugins at commit 3e1456a, republished under its Apache-2.0 licence (© hashgraph-online). 1,051 words, ~2,205 tokens.

Download SKILL.mdSave it as .claude/skills/progressive-disclosure-defaults-and-tucking/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
progressive-disclosure-defaults-and-tucking
description
Use this skill when deciding *what to surface* and *what to tuck* — the editorial choices behind progressive disclosure. Trigger when laying out a settings page, picking which form fields to show by default, deciding whether a section starts collapsed or open, or arguing about whether a feature deserves primary chrome or belongs in "Advanced." Sub-aspect of `progressive-disclosure`; read that first.

Progressive disclosure: defaults and tucking decisions

Progressive disclosure is mostly an editorial discipline. The technical patterns (accordions, tabs, "More" buttons) are easy; the hard work is deciding which content earns primary placement and which gets tucked. This skill is about that decision.

The framework: who, when, how often

For each candidate piece of content or control, ask three questions:

1. Who is it for?
  • Everyone (every user, every visit) → primary layer, always visible.
  • Most users (the typical case) → primary layer, visible by default.
  • Some users (specific roles or contexts) → secondary layer, disclosed by user action.
  • Few users (power users, edge cases) → secondary or tertiary layer, disclosed and possibly behind labels like "Advanced."
2. When is it needed?
  • Always → primary.
  • Per visit, but only sometimes per session → secondary, easy to reach.
  • Once during setup, never again → primary during setup, then move to settings.
  • Only on error / exception → don't show by default; surface on the relevant condition.
3. How often is it used?

This is the most concrete question — answerable from analytics.

  • Used by ≥ 50% of users on most visits → primary.
  • Used by 20–50% of users, or by everyone occasionally → primary, possibly with tighter visual treatment.
  • Used by 5–20% of users, or by power users routinely → secondary, behind one explicit affordance.
  • Used by < 5% of users → secondary or tertiary, possibly worth removing entirely.

These thresholds are rules of thumb; tune to your product. The bigger point: usage data is the strongest signal for tucking decisions, and most teams don't look at it before laying out chrome.

Defaulting disclosure state

When a section can start open or closed, choose deliberately:

Default open
  • The section the user is most likely to read or modify.
  • The section required to complete the task (if disclosure is in a form).
  • The first section in a sequence (so the user has somewhere to land).
  • A single-section accordion (if there's only one, it's not really collapsed by purpose).
Default closed
  • Sections that supplement the primary task.
  • "Advanced" or "Optional" sections.
  • Sections so long they'd dwarf the rest of the page if open.
  • Sections used by < 20% of users on a given visit.
Remember user state

For settings pages and frequent surfaces, remember which sections each user opened previously and restore on next visit:

js
// On open, persist
sectionToggle.addEventListener('toggle', () => {
  localStorage.setItem(`section-${sectionId}`, sectionToggle.open ? '1' : '0');
});

// On load, restore
const saved = localStorage.getItem(`section-${sectionId}`);
if (saved !== null) sectionToggle.open = saved === '1';

Power users who always reopen the same section will appreciate it; novices who never expand it pay no cost.

What earns primary placement

The primary layer is finite real estate. Be ruthless. A useful triage:

Always primary
  • The page's purpose-defining content. (A user lands on a Reports page; the report is primary.)
  • The required actions to complete the typical task. (A checkout flow; "Place order" is primary.)
  • Wayfinding chrome that orients the user.
Usually primary
  • Frequently-used controls.
  • Status indicators that change meaningfully (notification counts, error states).
  • Recently-used items (recents accelerate frequent tasks).
Sometimes primary
  • Customization options that vary by user role.
  • Onboarding hints for new users (but not for veterans).
  • Contextual help that depends on user state.
Rarely primary
  • Advanced configuration.
  • Account management (move to a separate page).
  • Marketing, upsells, "what's new."

What earns tucking

Conversely, candidates for the secondary or tertiary layer:

  • Optional fields in forms.
  • Power-user filters in search/list UIs.
  • Customization of layouts, themes, keyboard shortcuts.
  • Account / billing / security controls (their own page, not a sidebar accordion).
  • Help and documentation links (footer or help menu).
  • Legal / compliance links (footer).
  • Settings the user changes once and forgets (push to a "Preferences" page).

A worked example: a settings page audit

Imagine the current Settings page exposes 34 fields across 5 sections in a single scroll-y view. A progressive-disclosure pass might restructure as:

Profile (always visible at top)
  Display name
  Email
  Time zone

Notifications (accordion, default closed for users who haven't changed it)
  Email digest
  Mention notifications
  Quiet hours

Workspace (accordion, default closed)
  Workspace name
  Members [link to separate page]
  Default project

Security (separate page; link in nav)
  Password
  2FA
  Sessions
  API tokens

Advanced (accordion, default closed; appears only for users with the appropriate role)
  Webhooks
  Custom CSS
  Feature flags

Danger zone (separate panel at bottom; visually demoted)
  Transfer ownership
  Delete workspace

Profile (3 fields) is primary because every user changes their email or name occasionally. Security goes to its own page because it's high-stakes and benefits from its own focused surface. Advanced is conditional. Danger zone is at the bottom and visually distinct — out of the way of accidental engagement.

Show full SKILL.md (406 more words)Show less

Tucking dynamic content

Some content can't be tucked because it changes — notifications, real-time updates, error states. Patterns:

  • Badge on the disclosure trigger. A "Notifications (3)" trigger tells the user there's something behind it; they can choose to expand.
  • Toast / banner for transient changes. Auto-dismissing surface that doesn't require user action.
  • Modal for blocking changes. Forces the user to acknowledge.

Don't bury error states inside collapsed accordions. If a form section has an error, the section must be open (or auto-open on submit failure).

The "Advanced" label question

When a section is labeled "Advanced," users self-select. Power users open it; novices don't. This is mostly good — it manages expectations. But beware:

  • "Advanced" can be condescending. If a setting is just a bit unusual, calling it advanced may make users feel othered.
  • "Advanced" can be a dumping ground. If everything ungrouped goes under Advanced, the label loses meaning. Keep Advanced focused on power-user tools.
  • "Advanced" should be findable for power users. Don't bury Advanced inside Account inside Settings.

Alternative labels: "Optional," "More options," "Power tools," "For developers." Pick what fits the audience.

Anti-patterns

  • Hiding the required. Required form fields tucked behind disclosure. Submit fails; user is confused.
  • Disclosure for the sake of less. Hiding genuinely-needed controls "to make it cleaner." The user can't do their job.
  • All accordions closed. A page where every section is collapsed feels empty. Open the first one (or two) so the user lands.
  • Disclosure with no signal. "More options" with no hint of what's behind. Pair labels with semantic clues ("Advanced filters," "Additional fields").
  • Changing what's primary without telling users. A long-time user comes back to find a setting they relied on tucked into Advanced. Migration UX matters: announce the change.

Heuristics

  1. The "what would the typical user need?" test. For each visible element, ask: typical-user-typical-visit? If no, candidate for tucking.
  2. The analytics audit. Look at click data per control. <5% of users engage → strong tuck candidate. <1% → strong removal candidate.
  3. The new-user test. Walk a new user through the surface. Watch for which elements draw their attention vs. confuse them. Tuck the confusers.
  4. The expert-user test. Walk a power user through the surface. Watch what they reach for that's hidden. Surface those, or improve the disclosure affordance.
  • progressive-disclosure (parent).
  • progressive-disclosure-disclosure-affordances — the specific UI patterns for revealing tucked content.
  • 80-20-rule — the analytical method for identifying what's primary.
  • hicks-law-defaults — defaulting disclosure state is itself a Hick's Law mitigation.

© hashgraph-online, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in plugins/HDeibler/universal-design-principles/plugins/cognition-and-learnability-principles/skills/progressive-disclosure-defaults-and-tucking of hashgraph-online/awesome-codex-plugins.

  • SKILL.md
  • references/editorial-method.md

Open the folder on GitHubat commit 3e1456a

Compare with similar skills

Progressive Disclosure Defaults And Tucking next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Progressive Disclosure Defaults And Tucking compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Progressive Disclosure Defaults And Tucking this skillhashgraph-online/awesome-codex-plugins1.3k—~2.2kAutomated safety check: PassApache-2.0
Claude Md Progressive Disclosurerdaymade/claude-code-skills1.4k—~4.9kAutomated safety check: PassMIT
Workspace Surface Auditaffaan-m/ECC277k3 repos~1.3kAutomated safety check: NotesMIT
Affiliate Disclosurethedaviddias/Front-End-Checklist74k—~444Automated safety check: PassMIT
Progressive Jpegthedaviddias/Front-End-Checklist74k—~426Automated safety check: PassMIT
Progressive Buildingn8n-io/n8n207k—~1.6kAutomated safety check: PassCustom licence

Similar skills

  • Claude Md Progressive Disclosurer

    daymade/claude-code-skills

    Optimizes or restructures CLAUDE.md/AGENTS.md with progressive disclosure and zero information loss.

    1.4k GitHub stars~4.9k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Audit the active repo, MCP servers, plugins, connectors, env surfaces, and harness setup, then recommend the highest-value ECC-native skills, hooks, agents, and operator workflows.

    277k GitHub starsUsed in 3 repos~1.3k tokens
    Agent WorkflowsAuto-check: notes
  • Affiliate Disclosure

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing metadata, crawlability, structured data, or indexability related to Provide clear affiliate disclosures.

    74k GitHub stars~444 tokensUpdated 5 days ago
    Marketing & SEOAuto-check passed
  • Progressive Jpeg

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing image assets, markup, and CDN or build transforms related to Use progressive JPEG encoding.

    74k GitHub stars~426 tokensUpdated 5 days ago
    Auto-check passed
  • Official

    Load before build-workflow and before scoping or planning new workflows and feature additions, including requests spanning multiple workflows.

    207k GitHub stars~1.6k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Progressive Disclosure

    Neeeophytee/finding-unknowns-skills

    Split an oversized skill, CLAUDE.md, or spec into an entry file plus files that load only when they're needed.

    344 GitHub stars~660 tokensUpdated 13 days ago
    Agent WorkflowsAuto-check passed

More from hashgraph-online/awesome-codex-plugins

All 715 skills in this repo
  • Anime Reaction Gif

    hashgraph-online/awesome-codex-plugins

    Create original anime-style reaction stickers as looping GIFs and MP4 previews, using generated character pose sheets and timed key poses.

    1.3k GitHub stars~922 tokensUpdated today
    Auto-check passed
  • Calibredb

    hashgraph-online/awesome-codex-plugins

    Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs).

    1.3k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Rust API Test Harness

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when adding, changing, testing, or debugging Rust HTTP APIs and services, especially when Codex needs black-box integration tests, random-port app startup, real database test…

    1.3k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Art

    hashgraph-online/awesome-codex-plugins

    Make a studio's game look like something at build time — a cover from a real frame of the game (free), painted covers, backdrops, textures and character plates from image models through the…

    1.3k GitHub stars~2.5k tokensUpdated today
    Auto-check passed
  • Calle

    hashgraph-online/awesome-codex-plugins

    Use CALL-E from Codex through the calle CLI. An agent skill from hashgraph-online/awesome-codex-plugins.

    1.3k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Game Balance Economy

    hashgraph-online/awesome-codex-plugins

    Balance game difficulty, resources, rewards, probability, progression, economies, and dominant strategies.

    1.3k GitHub stars~618 tokensUpdated today
    Auto-check passed

Questions about Progressive Disclosure Defaults And Tucking

What does Progressive Disclosure Defaults And Tucking do?

A skill your agent uses when deciding what to surface and what to tuck — the editorial choices behind progressive disclosure. Progressive Disclosure Defaults And Tucking is an agent skill from hashgraph-online/awesome-codex-plugins. Use this skill when deciding what to surface and what to tuck — the editorial choices behind progressive disclosure.

When should I use Progressive Disclosure Defaults And Tucking?

Progressive Disclosure Defaults And Tucking fits situations like: deciding what to surface and what to tuck — the editorial choices behind progressive disclosure; laying out a settings page; picking which form fields to show by default; deciding whether a section starts collapsed.

How do I install Progressive Disclosure Defaults And Tucking in Claude Code?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill progressive-disclosure-defaults-and-tucking -a claude-code`. Or copy the skill folder (plugins/HDeibler/universal-design-principles/plugins/cognition-and-learnability-principles/skills/progressive-disclosure-defaults-and-tucking in hashgraph-online/awesome-codex-plugins) into .claude/skills/progressive-disclosure-defaults-and-tucking in your project. Claude Code loads it when a task matches its description.

How do I install Progressive Disclosure Defaults And Tucking in Codex?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill progressive-disclosure-defaults-and-tucking -a codex`. Or copy the skill folder (plugins/HDeibler/universal-design-principles/plugins/cognition-and-learnability-principles/skills/progressive-disclosure-defaults-and-tucking in hashgraph-online/awesome-codex-plugins) into .agents/skills/progressive-disclosure-defaults-and-tucking in your project. Codex loads it when a task matches its description.

Can I use Progressive Disclosure Defaults And Tucking in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hashgraph-online/awesome-codex-plugins --skill progressive-disclosure-defaults-and-tucking -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/progressive-disclosure-defaults-and-tucking, .gemini/skills/progressive-disclosure-defaults-and-tucking, .github/skills/progressive-disclosure-defaults-and-tucking and .opencode/skills/progressive-disclosure-defaults-and-tucking in your project.

What does Progressive Disclosure Defaults And Tucking need to run?

SKILL.md names no scripts, command-line tools or credentials: Progressive Disclosure Defaults And Tucking is instructions for the agent only.

Does Progressive Disclosure Defaults And Tucking access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Progressive Disclosure Defaults And Tucking safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Progressive Disclosure Defaults And Tucking use?

Progressive Disclosure Defaults And Tucking is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Progressive Disclosure Defaults And Tucking use?

About 2.2k tokens (SKILL.md is roughly 8.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.3k tokens, read only when the agent opens those files.

What are the alternatives to Progressive Disclosure Defaults And Tucking?

Skills that share tags, products or a category with Progressive Disclosure Defaults And Tucking: Claude Md Progressive Disclosurer (daymade/claude-code-skills, 1.4k stars), Workspace Surface Audit (affaan-m/ECC, 277k stars), Affiliate Disclosure (thedaviddias/Front-End-Checklist, 74k stars) and Progressive Jpeg (thedaviddias/Front-End-Checklist, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Progressive Disclosure Defaults And Tucking?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,267 GitHub stars. The repository holds 716 skills in this directory. The repository was last updated on October 10, 2026.

Source: hashgraph-online/awesome-codex-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.