How do I install the Gsd Surface skill?

Run npx skillmds@latest add lgwanai/gsd-surface in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Gsd Surface safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Gsd Surface?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Gsd Surface free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Gsd Surface?

lgwanai (@lgwanai) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gsd Surface by lgwanai — Agent Skill

Name: Gsd Surface
Author: lgwanai

File contents

Sub-commands: list · status · profile · disable · enable · reset

Sub-command routing

Parse the first token of $ARGUMENTS:

Token	Action
`list`	Show enabled + disabled clusters and skills
`status`	Alias for `list` plus token cost summary
`profile <name>`	Write `baseProfile` and re-stage
`profile <n1>,<n2>`	Composed profiles (comma-separated, no spaces)
`disable <cluster>`	Add cluster to `disabledClusters`, re-stage
`enable <cluster>`	Remove cluster from `disabledClusters`, re-stage
`reset`	Delete `.gsd-surface.json`, return to install-time profile
(none)	Treat as `list`

list / status

Call listSurface(runtimeConfigDir, manifest, CLUSTERS) from get-shit-done/bin/lib/surface.cjs. Display:

Enabled (N skills, ~T tokens):
  core_loop:   new-project  discuss-phase  plan-phase  execute-phase  help  update
  audit_review: …
  …

Disabled:
  utility:  health  stats  settings  …

Token cost: ~T (budget cap ~500 tokens for 200k context @ 1%)

For status also append:

Base profile:   standard  (from .gsd-surface.json)
Install profile: standard  (from .gsd-profile)

profile <name>

Read current surface: readSurface(runtimeConfigDir) → if null, seed from readActiveProfile(runtimeConfigDir).
Set surfaceState.baseProfile = name.
writeSurface(runtimeConfigDir, surfaceState).
Resolve and re-apply: applySurface(runtimeConfigDir, commandsDir, agentsDir, manifest, CLUSTERS).
Confirm: "Surface updated to profile <name>. N skills enabled."

disable <cluster>

Valid cluster names: core_loop, audit_review, milestone, research_ideate, workspace_state, docs, ui, ai_eval, ns_meta, utility.

Validate cluster name against Object.keys(CLUSTERS).
Read or initialize surface state.
Add cluster to surfaceState.disabledClusters (deduplicate).
writeSurface → applySurface.
Confirm: "Disabled cluster <cluster>. N skills removed from surface."

enable <cluster>

Read surface state; if null, nothing to enable — print "No surface delta active."
Remove cluster from surfaceState.disabledClusters.
writeSurface → applySurface.
Confirm: "Enabled cluster <cluster>. N skills added back to surface."

reset

Check if .gsd-surface.json exists.
Delete it.
Re-apply using only readActiveProfile(runtimeConfigDir) (install-time profile).
Confirm: "Surface reset to install-time profile <name>."

runtimeConfigDir resolution

# Claude Code
RUNTIME_CONFIG_DIR=$HOME/.claude/skills

# Resolve commandsDir and agentsDir
COMMANDS_DIR=$HOME/.claude/commands/gsd
AGENTS_DIR=$HOME/.claude/agents

All paths can be overridden by reading the CLAUDE_CONFIG_DIR env var if set.

Error handling

Unknown cluster name → list valid cluster names, exit without writing.
Unknown profile name → list known profiles (core, standard, full), exit.
Missing surface.cjs → prompt: "Run npm i -g get-shit-done to reinstall GSD."

---name: gsd-surfacedescription: Toggle which skills are surfaced — apply a profile, list, or disable a cluster without reinstall---<objective>Manage the runtime skill surface without reinstall. Reads/writes `$HOME/.claude/skills/.gsd-surface.json`(sibling to `.gsd-profile`) and re-stages the active commands/gsd directory in place.Sub-commands: list · status · profile · disable · enable · reset</objective>## Sub-command routingParse the first token of $ARGUMENTS:| Token | Action ||---|---|| `list` | Show enabled + disabled clusters and skills || `status` | Alias for `list` plus token cost summary || `profile <name>` | Write `baseProfile` and re-stage || `profile <n1>,<n2>` | Composed profiles (comma-separated, no spaces) || `disable <cluster>` | Add cluster to `disabledClusters`, re-stage || `enable <cluster>` | Remove cluster from `disabledClusters`, re-stage || `reset` | Delete `.gsd-surface.json`, return to install-time profile || *(none)* | Treat as `list` |---## list / statusCall `listSurface(runtimeConfigDir, manifest, CLUSTERS)` from`get-shit-done/bin/lib/surface.cjs`. Display:```Enabled (N skills, ~T tokens): core_loop: new-project discuss-phase plan-phase execute-phase help update audit_review: … …Disabled: utility: health stats settings …Token cost: ~T (budget cap ~500 tokens for 200k context @ 1%)```For `status` also append:```Base profile: standard (from .gsd-surface.json)Install profile: standard (from .gsd-profile)```---## profile \<name\>1. Read current surface: `readSurface(runtimeConfigDir)` → if null, seed from `readActiveProfile(runtimeConfigDir)`.2. Set `surfaceState.baseProfile = name`.3. `writeSurface(runtimeConfigDir, surfaceState)`.4. Resolve and re-apply: `applySurface(runtimeConfigDir, commandsDir, agentsDir, manifest, CLUSTERS)`.5. Confirm: "Surface updated to profile `<name>`. N skills enabled."---## disable \<cluster\>Valid cluster names: `core_loop`, `audit_review`, `milestone`, `research_ideate`,`workspace_state`, `docs`, `ui`, `ai_eval`, `ns_meta`, `utility`.1. Validate cluster name against `Object.keys(CLUSTERS)`.2. Read or initialize surface state.3. Add cluster to `surfaceState.disabledClusters` (deduplicate).4. `writeSurface` → `applySurface`.5. Confirm: "Disabled cluster `<cluster>`. N skills removed from surface."---## enable \<cluster\>1. Read surface state; if null, nothing to enable — print "No surface delta active."2. Remove cluster from `surfaceState.disabledClusters`.3. `writeSurface` → `applySurface`.4. Confirm: "Enabled cluster `<cluster>`. N skills added back to surface."---## reset1. Check if `.gsd-surface.json` exists.2. Delete it.3. Re-apply using only `readActiveProfile(runtimeConfigDir)` (install-time profile).4. Confirm: "Surface reset to install-time profile `<name>`."---## runtimeConfigDir resolution```bash# Claude CodeRUNTIME_CONFIG_DIR=$HOME/.claude/skills# Resolve commandsDir and agentsDirCOMMANDS_DIR=$HOME/.claude/commands/gsdAGENTS_DIR=$HOME/.claude/agents```All paths can be overridden by reading the `CLAUDE_CONFIG_DIR` env var if set.---## Error handling- Unknown cluster name → list valid cluster names, exit without writing.- Unknown profile name → list known profiles (`core`, `standard`, `full`), exit.- Missing `surface.cjs` → prompt: "Run `npm i -g get-shit-done` to reinstall GSD."<execution_context>Surface state file: `$HOME/.claude/skills/.gsd-surface.json`Install profile marker: `$HOME/.claude/skills/.gsd-profile`Engine module: `$HOME/.claude/get-shit-done/bin/lib/surface.cjs`Cluster definitions: `$HOME/.claude/get-shit-done/bin/lib/clusters.cjs`</execution_context>

Frequently asked questions

Gsd Surface