gsd-surface

Toggle active GSD skill surfaces and manage profiles via the .gsd-surface state file.

Updated May 22, 2026
One-click install
npx skills add https://github.com/yusaduymaz/loexai --skill gsd-surface-yusaduymaz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-surface
Source: https://github.com/yusaduymaz/loexai/tree/main/.codex/skills/gsd-surface
Command: npx skills add https://github.com/yusaduymaz/loexai --skill gsd-surface-yusaduymaz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill lets you change which GSD skills are visible and active at runtime without reinstalling or rebuilding the whole skill set.

Core Features & Use Cases

  • List the surface: See which clusters and skills are enabled or disabled.
  • Switch profiles: Apply base profiles such as core, standard, or full, or compose multiple profiles.
  • Control clusters: Enable or disable clusters like docs, ui, utility, or audit_review for a tailored workspace.
  • Use Case: A maintainer can quickly reduce the active surface to only core workflow skills before a focused session, then restore the full surface afterward.

Quick Start

Use gsd-surface to show the current surface, then enable, disable, choose a profile, or reset it as needed.

Frequently Asked Questions about gsd-surface

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

FAQPage Schema
How do I switch skill profiles at runtime without reinstalling?

To switch skill profiles at runtime without reinstalling, use gsd-surface to reapply a different active profile layout. It reads the .gsd-surface state file and updates your runtime configuration to toggle the active skill surface immediately.

What is runtime skill surface control and when do I need it?

Runtime skill surface control is the ability to change which skill clusters are visible and active without rebuilding. You need it to reduce workspace distractions by enabling only core workflow skills before a focused session, then restoring the full surface afterward.

Can I enable or disable specific skill clusters like docs or ui individually?

Yes, you can enable or disable specific skill clusters like docs, ui, utility, or audit_review individually. gsd-surface validates cluster names and updates the runtime configuration to give you a tailored workspace with only the clusters you need active.

How do I list which skill clusters are currently enabled or disabled?

To list which skill clusters are currently enabled or disabled, use gsd-surface to show the current surface. It reads the .gsd-surface state file and displays the active profile layout along with the status of all available skill clusters.

What's the best way to reset my skill surface configuration back to defaults?

The best way to reset your skill surface configuration back to defaults is using the reset behavior in gsd-surface. It validates reset parameters and rewrites the .gsd-surface state file to restore the original active profile layout.