Communitygithub.com

NVlabs/Skill2Env

只读队列仪表盘,用于工作区感知的ship操作(gstack)。

Skill2Env 是什么?

该技能(NVlabs/Skill2Env)实现了一个名为“/landing-report”的只读版本队列仪表盘,专为gstack工作流设计。它能显示当前由开放PR声明的VERSION插槽、兄弟Conductor工作区中即将ship的WIP工作,以及/ship将选择的下一个插槽。此技能不进行任何数据变更,仅提供快照视图。适用于开发者询问“landing report”、“队列状态”、“显示开放PR”或“下一个要声明的版本”等场景。技能支持Claude Code、Cursor、Codex等平台,通过一系列Shell命令收集环境变量(如分支名、会话类型、是否在Conductor中运行)和配置,然后由AI代理根据这些信息生成响应。此外,该技能包含计划模式安全操作、首次运行引导、功能发现提示(如连续检查点、遥测配置、主动技能建议)等丰富的交互逻辑,以确保在多种工作模式下正确运行。

兼容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/NVlabs/Skill2Env/tree/HEAD/SkillHub/skills/garry-tan/gstack/landing-report

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

何时调用此技能

显示哪些VERSION插槽当前被开放PR占用、哪些兄弟Conductor工作区有即将ship的WIP工作,以及/ship会选取的下一个插槽。不做任何变更——仅提供快照。当用户要求“landing report”、“队列状态”、“显示开放PR”或“下一个要声明的版本”时使用。

/landing-report — 版本队列仪表盘

前言(先运行)

_UPD=$(~/.claude/skills/gstack/bin/gstack-update-check 2>/dev/null || .claude/skills/gstack/bin/gstack-update-check 2>/dev/null || true)
[ -n "$_UPD" ] && echo "$_UPD" || true
mkdir -p ~/.gstack/sessions
touch ~/.gstack/sessions/"$PPID"
_SESSIONS=$(find ~/.gstack/sessions -mmin -120 -type f 2>/dev/null | wc -l | tr -d ' ')
find ~/.gstack/sessions -mmin +120 -type f -exec rm {} + 2>/dev/null || true
_PROACTIVE=$(~/.claude/skills/gstack/bin/gstack-config get proactive 2>/dev/null || echo "true")
_PROACTIVE_PROMPTED=$([ -f ~/.gstack/.proactive-prompted ] && echo "yes" || echo "no")
_BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
echo "BRANCH: $_BRANCH"
_SKILL_PREFIX=$(~/.claude/skills/gstack/bin/gstack-config get skill_prefix 2>/dev/null || echo "false")
echo "PROACTIVE: $_PROACTIVE"
echo "PROACTIVE_PROMPTED: $_PROACTIVE_PROMPTED"
echo "SKILL_PREFIX: $_SKILL_PREFIX"
source <(~/.claude/skills/gstack/bin/gstack-repo-mode 2>/dev/null) || true
REPO_MODE=${REPO_MODE:-unknown}
echo "REPO_MODE: $REPO_MODE"
_SESSION_KIND=$(~/.claude/skills/gstack/bin/gstack-session-kind 2>/dev/null || echo "interactive")
case "$_SESSION_KIND" in spawned|headless|interactive) ;; *) _SESSION_KIND="interactive" ;; esac
echo "SESSION_KIND: $_SESSION_KIND"
# Conductor 主机:这里 AskUserQuestion 不可靠(原生禁用,MCP 变体不稳定),
# 因此技能以散文形式呈现决策,而不是调用工具。仅在非 headless 时生效,
# 这样在 Conductor 内部运行(GSTACK_HEADLESS)的 eval/CI 仍然 BLOCK,
# 而不是向无人展示散文。
if [ "$_SESSION_KIND" != "headless" ] && { [ -n "${CONDUCTOR_WORKSPACE_PATH:-}" ] || [ -n "${CONDUCTOR_PORT:-}" ]; }; then
  echo "CONDUCTOR_SESSION: true"
fi
_ACTIVATED=$([ -f ~/.gstack/.activated ] && echo "yes" || echo "no")
_FIRST_LOOP_SHOWN=$([ -f ~/.gstack/.first-loop-tip-shown ] && echo "yes" || echo "no")
echo "ACTIVATED: $_ACTIVATED"
echo "FIRST_LOOP_SHOWN: $_FIRST_LOOP_SHOWN"
# 首次运行项目检测:仅在首次技能运行时运行检测器
# (ACTIVATED=no,交互式),以使其远离每次运行的热路径。
_FIRST_TASK=""
if [ "$_ACTIVATED" = "no" ] && [ "$_SESSION_KIND" != "headless" ]; then
  _FIRST_TASK=$(~/.claude/skills/gstack/bin/gstack-first-task-detect 2>/dev/null || true)
fi
echo "FIRST_TASK: $_FIRST_TASK"
_LAKE_SEEN=$([ -f ~/.gstack/.completeness-intro-seen ] && echo "yes" || echo "no")
echo "LAKE_INTRO: $_LAKE_SEEN"
_TEL=$(~/.claude/skills/gstack/bin/gstack-config get telemetry 2>/dev/null || true)
_TEL_PROMPTED=$([ -f ~/.gstack/.telemetry-prompted ] && echo "yes" || echo "no")
_TEL_START=$(date +%s)
_SESSION_ID="$$-$(date +%s)"
echo "TELEMETRY: ${_TEL:-off}"
echo "TEL_PROMPTED: $_TEL_PROMPTED"
_EXPLAIN_LEVEL=$(~/.claude/skills/gstack/bin/gstack-config get explain_level 2>/dev/null || echo "default")
if [ "$_EXPLAIN_LEVEL" != "default" ] && [ "$_EXPLAIN_LEVEL" != "terse" ]; then _EXPLAIN_LEVEL="default"; fi
echo "EXPLAIN_LEVEL: $_EXPLAIN_LEVEL"
_QUESTION_TUNING=$(~/.claude/skills/gstack/bin/gstack-config get question_tuning 2>/dev/null || echo "false")
echo "QUESTION_TUNING: $_QUESTION_TUNING"
mkdir -p ~/.gstack/analytics
if [ "$_TEL" != "off" ]; then
echo '{"skill":"landing-report","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","repo":"'$(_repo=$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null | tr -cd 'a-zA-Z0-9._-'); echo "${_repo:-unknown}")"'}'  >> ~/.gstack/analytics/skill-usage.jsonl 2>/dev/null || true
fi
for _PF in $(find ~/.gstack/analytics -maxdepth 1 -name '.pending-*' 2>/dev/null); do
  if [ -f "$_PF" ]; then
    if [ "$_TEL" != "off" ] && [ -x "~/.claude/skills/gstack/bin/gstack-telemetry-log" ]; then
      ~/.claude/skills/gstack/bin/gstack-telemetry-log --event-type skill_run --skill _pending_finalize --outcome unknown --session-id "$_SESSION_ID" 2>/dev/null || true
    fi
    rm -f "$_PF" 2>/dev/null || true
  fi
  break
done
eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)" 2>/dev/null || true
_LEARN_FILE="${GSTACK_HOME:-$HOME/.gstack}/projects/${SLUG:-unknown}/learnings.jsonl"
if [ -f "$_LEARN_FILE" ]; then
  _LEARN_COUNT=$(wc -l < "$_LEARN_FILE" 2>/dev/null | tr -d ' ')
  echo "LEARNINGS: $_LEARN_COUNT entries loaded"
  if [ "$_LEARN_COUNT" -gt 5 ] 2>/dev/null; then
    ~/.claude/skills/gstack/bin/gstack-learnings-search --limit 3 2>/dev/null || true
  fi
else
  echo "LEARNINGS: 0"
fi
~/.claude/skills/gstack/bin/gstack-timeline-log '{"skill":"landing-report","event":"started","branch":"'"$_BRANCH"'","session":"'"$_SESSION_ID"'"}' 2>/dev/null &
_HAS_ROUTING="no"
if [ -f CLAUDE.md ] && grep -q "## Skill routing" CLAUDE.md 2>/dev/null; then
  _HAS_ROUTING="yes"
fi
_ROUTING_DECLINED=$(~/.claude/skills/gstack/bin/gstack-config get routing_declined 2>/dev/null || echo "false")
echo "HAS_ROUTING: $_HAS_ROUTING"
echo "ROUTING_DECLINED: $_ROUTING_DECLINED"
_VENDORED="no"
if [ -d ".claude/skills/gstack" ] && [ ! -L ".claude/skills/gstack" ]; then
  if [ -f ".claude/skills/gstack/VERSION" ] || [ -d ".claude/skills/gstack/.git" ]; then
    _VENDORED="yes"
  fi
fi
echo "VENDORED_GSTACK: $_VENDORED"
echo "MODEL_OVERLAY: claude"
_CHECKPOINT_MODE=$(~/.claude/skills/gstack/bin/gstack-config get checkpoint_mode 2>/dev/null || echo "explicit")
_CHECKPOINT_PUSH=$(~/.claude/skills/gstack/bin/gstack-config get checkpoint_push 2>/dev/null || echo "false")
echo "CHECKPOINT_MODE: $_CHECKPOINT_MODE"
echo "CHECKPOINT_PUSH: $_CHECKPOINT_PUSH"
# 计划模式提示:用于像 /spec 这样的技能,根据计划模式状态分支行为。
# Claude Code 通过系统提醒暴露计划模式;我们尽最大努力从
# CLAUDE_PLAN_FILE(当计划模式激活时由 harness 设置)检测,
# 并回退到 "inactive"。Codex 主机和 Claude 执行模式都最终为
# 非活动状态,这是安全的默认值(默认为文件+执行管道)。
if [ -n "${CLAUDE_PLAN_FILE:-}${GSTACK_PLAN_MODE_FORCE:-}" ]; then
  export GSTACK_PLAN_MODE="active"
elif [ "${GSTACK_PLAN_MODE:-}" = "active" ]; then
  export GSTACK_PLAN_MODE="active"
else
  export GSTACK_PLAN_MODE="inactive"
fi
echo "GSTACK_PLAN_MODE: $GSTACK_PLAN_MODE"
[ -n "$OPENCLAW_SESSION" ] && echo "SPAWNED_SESSION: true" || true

计划模式安全操作

在计划模式下,允许以下操作,因为它们用于告知计划:$B、$D、codex exec/codex review、写入 ~/.gstack/、写入计划文件,以及 open 用于生成的工件。

计划模式下的技能调用

如果用户在计划模式下调用某个技能,则该技能优先于泛化的计划模式行为。将技能文件视为可执行指令,而非参考。 从第 0 步开始逐步执行;第一个 AskUserQuestion 是工作流进入计划模式,并非违反计划模式。AskUserQuestion(任何变体——mcp__*__AskUserQuestion 或原生;参见“AskUserQuestion 格式 → 工具解析”)满足计划模式的回合结束要求。如果 AskUserQuestion 不可用或调用失败,则遵循 AskUserQuestion 格式失败回退:headless → BLOCKED;interactive → 散文回退(也满足回合结束)。在 STOP 点,立即停止。不要继续工作流或在此调用 ExitPlanMode。标记为“PLAN MODE EXCEPTION — ALWAYS RUN”的命令将执行。仅在技能工作流完成后,或用户告知你取消技能或离开计划模式时,才调用 ExitPlanMode。

如果 PROACTIVE 为 "false",则不要自动调用或主动建议技能。如果某技能似乎有用,请询问:“我认为 /skillname 可能对此有帮助——要运行它吗?”

如果 SKILL_PREFIX 为 "true",则建议/调用 /gstack-* 名称。磁盘路径保持为 ~/.claude/skills/gstack/[skill-name]/SKILL.md。

如果输出显示 UPGRADE_AVAILABLE <old> <new>:读取 ~/.claude/skills/gstack/gstack-upgrade/SKILL.md 并遵循“内联升级流程”(如果配置则自动升级,否则通过 AskUserQuestion 提供 4 个选项,如果拒绝则写入休眠状态)。

如果输出显示 JUST_UPGRADED <from> <to>:打印“正在运行 gstack v{to}(刚刚更新!)”。如果 SPAWNED_SESSION 为 true,则跳过功能发现。

功能发现,每个会话最多一个提示:

  • 缺少 ~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint:通过 AskUserQuestion 询问是否启用持续检查点自动提交。如果接受,运行 ~/.claude/skills/gstack/bin/gstack-config set checkpoint_mode continuous。始终触摸标记文件。
  • 缺少 ~/.claude/skills/gstack/.feature-prompted-model-overlay:告知“模型覆盖已激活。MODEL_OVERLAY 显示补丁。”始终触摸标记文件。

升级提示后,继续工作流。

如果 WRITING_STYLE_PENDING 为 yes:询问一次书写风格:

v1 提示更简单:首次使用的术语注释、结果导向的问题、更短的散文。保持默认还是恢复简洁?

选项:

  • A) 保持新的默认(推荐——良好的书写对每个人都有帮助)
  • B) 恢复 V0 散文——设置 explain_level: terse

如果 A:保持 explain_level 未设置(默认为 default)。 如果 B:运行 ~/.claude/skills/gstack/bin/gstack-config set explain_level terse。

始终运行(无论选择如何):

rm -f ~/.gstack/.writing-style-prompt-pending
touch ~/.gstack/.writing-style-prompted

如果 WRITING_STYLE_PENDING 为 no,则跳过。

如果 LAKE_INTRO 为 no:说“gstack 遵循 Boil the Ocean 原则——当 AI 使边际成本接近零时,做完整的事情。阅读更多:https://garryslist.org/posts/boil-the-ocean” 提供打开链接的选项:

open https://garryslist.org/posts/boil-the-ocean
touch ~/.gstack/.completeness-intro-seen

仅当用户同意时才运行 open。始终运行 touch。

如果 TEL_PROMPTED 为 no 且 LAKE_INTRO 为 yes:通过 AskUserQuestion 询问遥测一次:

帮助 gstack 变得更好。仅共享使用数据:技能、持续时间、崩溃、稳定的设备 ID。不共享代码或文件路径。你的仓库名称仅在本地记录,并在任何上传前被剥离。

选项:

  • A) 帮助 gstack 变得更好!(推荐)
  • B) 不了,谢谢

如果 A:运行 ~/.claude/skills/gstack/bin/gstack-config set telemetry community

如果 B:询问后续问题:

匿名模式仅发送聚合使用数据,无唯一 ID。

选项:

  • A) 好的,匿名也没问题
  • B) 不了,谢谢,完全关闭

如果 B→A:运行 ~/.claude/skills/gstack/bin/gstack-config set telemetry anonymous 如果 B→B:运行 ~/.claude/skills/gstack/bin/gstack-config set telemetry off

始终运行:

touch ~/.gstack/.telemetry-prompted

如果 TEL_PROMPTED 为 yes,则跳过。

如果 PROACTIVE_PROMPTED 为 no 且 TEL_PROMPTED 为 yes:询问一次:

让 gstack 主动建议技能,比如针对“这个能工作吗?”的 /qa 或针对错误的 /investigate?

选项:

  • A) 保持开启(推荐)
  • B) 关闭——我会自己输入 /commands

如果 A:运行 ~/.claude/skills/gstack/bin/gstack-config set proactive true 如果 B:运行 ~/.claude/skills/gstack/bin/gstack-config set proactive false

始终运行:

touch ~/.gstack/.proactive-prompted

如果 PROACTIVE_PROMPTED 为 yes,则跳过。

首次运行引导(一次性)

如果 ACTIVATED 为 no(此机器上首次运行技能)且前言打印了非空的 FIRST_TASK: 值且不是 nongit:根据令牌显示一个简短的项目特定提示行,然后继续处理用户实际请求的任务——不要中断他们的任务。令牌映射:greenfield → “新仓库——先用 /spec 或 /office-hours 塑造它。” code_node/code_python/code_rust/code_go/code_ruby/code_ios → “这里有代码——用 /qa 查看其运行,或用 /investigate 排查问题。” branch_ahead → “此分支上有未发布的工作——先 /review 再 /ship。” dirty_default → “有未提交的更改——先 /review 再提交。” clean_default → “选择一个:/spec、/investigate 或 /qa。” 然后,将你看到的令牌替换为 TASK_TOKEN 并运行(尽力而为),并标记为已激活:

~/.claude/skills/gstack/bin/gstack-telemetry-log --event-type first_task_scaffold_shown --skill "TASK_TOKEN" --outcome shown 2>/dev/null || true
touch ~/.gstack/.activated 2>/dev/null || true

如果 ACTIVATED 为 no 但 FIRST_TASK: 为空或为 nongit(headless、非 git 或无操作项):不显示任何内容,仅运行 touch ~/.gstack/.activated 2>/dev/null || true。

否则,如果 ACTIVATED 为 yes 且 FIRST_LOOP_SHOWN 为 no:作为提示说一次(然后继续):

提示:当你完成一个循环时,gstack 的价值最大——规划 → 审查 → 发布。一个常见的第一个循环:先 /office-hours 或 /spec 来塑造它,然后 /plan-eng-review 来锁定它,最后 /ship。

然后运行 touch ~/.gstack/.first-loop-tip-shown 2>/dev/null || true。

如果 ACTIVATED 和 FIRST_LOOP_SHOWN 都为 yes,则跳过此部分。

如果 HAS_ROUTING 为 no 且 ROUTING_DECLINED 为 false 且 PROACTIVE_PROMPTED 为 yes: 检查项目根目录下是否存在 CLAUDE.md 文件。如果不存在,则创建它。

使用 AskUserQuestion:

当你的项目的 CLAUDE.md 包含技能路由规则时,gstack 表现最佳。

选项:

  • A) 向 CLAUDE.md 添加路由规则(推荐)
  • B) 不了,谢谢,我会手动调用技能

如果 A:将以下部分附加到 CLAUDE.md 末尾:


## Skill routing

When the user's request matches an available skill, invoke it via the Skill tool. When in doubt, invoke the skill.

Key routing rules:
- Product ideas/brainstorming → invoke /office-hours
- Strategy/scope → invoke /plan-ceo-review
- Architecture → invoke /plan-eng-review
- Design system/plan review → invoke /design-consultation or /plan-design-review
- Full review pipeline → invoke /autoplan
- Bugs/errors → invoke

...

[此处已截断以进行翻译]

如果 B:运行 ~/.claude/skills/gstack/bin/gstack-config set routing_declined true。

始终运行:

touch ~/.gstack/.routing-prompted

Individual skills in this repo

This repo contains 13 individual skills — each has its own dedicated page.

NVlabs/Skill2Env

This skill should be used when the user asks about "digital portfolio", "portfolio website", "project description", "case study", "portfolio curation", "creative portfolio", "act as a portfolio curator", "portfolio curator mode", "portfolio review", "professional presentation", "portfolio architecture", "work samples", "portfolio bio", or needs expertise in building, structuring, and writing professional digital portfolios. Part of the AlterLab FC Skills collection (New Media & Communication department).

NVlabs/Skill2Env

This skill should be used when the user asks about "web content strategy", "SEO writing", "UX writing", "information architecture", "content architecture", "website structure", "act as a web content strategist", "web strategist mode", "site map", "content audit", "microcopy", "meta descriptions", "content hierarchy", "content governance", or needs expertise in planning, structuring, and writing content for websites and digital platforms. Part of the AlterLab FC Skills collection (New Media & Communication department).

NVlabs/Skill2Env

When the user wants to create, generate, or produce video content using AI tools or programmatic frameworks. Also use when the user mentions 'video production,' 'AI video,' 'Remotion,' 'Hyperframes,' 'HeyGen,' 'Synthesia,' 'Veo,' 'Sora,' 'Runway,' 'Kling,' 'Seedance,' 'Hailuo,' 'MiniMax,' 'Pika,' 'Hunyuan,' 'Wan,' 'video generation,' 'AI avatar,' 'talking head video,' 'programmatic video,' 'video template,' 'explainer video,' 'product demo video,' 'video pipeline,' or 'make me a video.' Use this for video creation, generation, and production workflows. For video content strategy and what to post, see social. For paid video ad creative, see ad-creative.

NVlabs/Skill2Env

Balance visual design with ATS compatibility for creative roles

NVlabs/Skill2Env

Build immersive, cinematic 2.5D interactive websites using scroll storytelling, parallax depth, text animations, and premium scroll effects — no WebGL required. Use this skill for any web design task: landing pages, product sites, hero sections, scroll animations, parallax, sticky sections, section overlaps, floating products between sections, clip-path reveals, text that flies in from sides, words that light up on scroll, curtain drops, iris opens, card stacks, bleed typography, and any site that should feel cinematic or premium. Trigger on phrases like "make it feel alive", "Apple-style animation", "sections that overlap", "product rises between sections", "immersive", "scrollytelling", or any scroll-driven visual effect. Covers 45+ techniques across 8 categories. Always inspects, judges, and plans assets before coding. Use aggressively for ANY web design task.

NVlabs/Skill2Env

Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.

NVlabs/Skill2Env

Audits any landing or service page across 48 checks in 10 categories for LLM/AI discoverability, GEO readiness, content clarity, schema markup, internal linking, freshness signals, and technical crawlability. Produces an overall score out of 100, a per-category score out of 100, pass/warn/fail/ manual counts, and a prioritised fix list — all rendered as a standalone HTML report saved to disk. Use when a user provides a URL and asks to audit it, score it, check its GEO readiness, test its AI discoverability, run a landing page audit, or evaluate it for LLM citation potential. Also trigger on phrases like "audit this page", "score this URL", "check GEO for", "is this page AI-ready", "run a GEO audit", "LLM page check", "how would AI read this page", or "landing page score".

NVlabs/Skill2Env

Generates a premium single-page HTML landing page with 3D CSS animations, GSAP scroll effects, and mouse-parallax depth. Forcing intake (product + elevator pitch, audience register, brand overrides, tone) locks down positioning before any copy or markup is written, so the page reflects the actual product rather than generic boilerplate. Use whenever the user says 'landing for X', 'create a landing page', 'build a landing page', 'make a landing page for X', 'I need a web page for Y', or provides product/service details and wants a polished website. Also triggers on 'promotional page', 'product page', 'one-pager', 'web presence', 'sales page'. Outputs a single self-contained HTML file (Claude Code) or HTML artifact (Claude.ai). Supports configurable brand colors via CSS custom property overrides.

NVlabs/Skill2Env

Use when a user asks to build, optimize, backtest, rebalance, or analyze a stock portfolio with Mean-CVaR, efficient frontiers, scenario generation, or NVIDIA cuOpt.

NVlabs/Skill2Env

Transform resume bullets into detailed portfolio case studies

NVlabs/Skill2Env

Generates high-converting landing pages as complete Next.js/React (TSX) components with Tailwind CSS. Creates hero sections, feature grids, pricing tables, FAQ accordions, testimonial blocks, and CTA sections using proven copy frameworks (PAS, AIDA, BAB). Outputs SEO meta tags, structured data, and performance-optimised code targeting Core Web Vitals (LCP < 1s, CLS < 0.1). Use when the user asks to create a landing page, marketing page, homepage, single-page site, lead capture page, campaign page, promo page, or conversion-optimised web page — or when they want to A/B test landing page variants or replace a static page with one designed to convert.

NVlabs/Skill2Env

> Visual design direction framework organized by emotional intent (Warm/Cold x Active/Calm). The first design reference system that categorizes sites by what they make you FEEL, not how they look. Includes 48 annotated public website references.

NVlabs/Skill2Env

Run a structured 5-pass finishing audit on any website before launch — scoring visual polish, technical foundation, UX completeness, content quality, and cross-device readiness on 100 points. Use when: **Pre-launch** - Final validation before going live; **Post-redesign** - Verify nothing broke during the overhaul; **Client handoff** - Structured proof that the site is ready; **Quarterly review** - Catch accumulated debt; **Single-pass focus** - Run just Pass 2 after a perf sprint

相关技能