Communitygithub.com

Biznomad/agent-skills

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

agent-skills 是什么?

这是一个名为 `/landing-report` 的工具,属于 gstack 技能集,旨在为 AI 代理(如 Claude Code、Cursor、Codex 等)提供一个只读的版本队列仪表盘。它主要展示哪些版本槽位(VERSION slots)被当前的拉取请求(PR)占用,哪些同级的 Conductor 工作区有即将发布的工作(WIP),以及下次 `/ship` 会选择哪个槽位。该工具不会进行任何修改,仅提供当前状态的快照。用户可以通过“landing report”、“what's in the queue”、“show me open PRs”或“which version do I claim next”等提示来触发此技能。它适用于有多个工作区和版本管理需求的开发团队,帮助他们在发布前了解队列状态。

兼容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-skills/tree/HEAD/landing-report

在你喜欢的 AI 中提问

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

文档

何时调用此技能

显示哪些 VERSION 槽位 当前被开放的 PR 占用,哪些同级的 Conductor 工作区有 即将发布的 WIP 工作,以及下次 /ship 将选择哪个槽位。不会进行任何修改——仅提供快照。当被要求“landing report”、“what's in the queue”、“show me open PRs”或“which version do I claim next”时使用。

/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 host: AskUserQuestion 在此处不可靠(原生禁用,MCP
# 变体不稳定),因此技能将决策渲染为散文,而不是调用该工具。
# 仅限于非 headless 模式,以便在 Conductor 内部的评估/CI 运行(GSTACK_HEADLESS)
# 仍然 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 执行模式最终都是 inactive,这是安全默认值(默认为文件+执行管道)。
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 个选项,如果拒绝则写入 snooze 状态)。

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

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

  • 缺少 ~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint:询问用户是否启用连续检查点自动提交。如果接受,运行 ~/.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

…

Individual skills in this repo

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

Biznomad/agent-skills

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says "landing page", "post-click experience", "landing page audit", "conversion rate", or "landing page optimization".

Biznomad/agent-skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 25 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says "TikTok Ads", "TikTok marketing", "TikTok Shop", "Spark Ads", "Smart+", or "TikTok campaign".

Biznomad/agent-skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, and Demand Gen formats. Use when user says "YouTube Ads", "video ads", "pre-roll", "bumper ads", "YouTube campaign", or "Shorts ads".

Biznomad/agent-skills

Help users get promoted at work. Use when someone is preparing for a promotion conversation, building their case for advancement, trying to understand what's blocking their promotion, or figuring out how to get to the next level in their career.

Biznomad/agent-skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

Biznomad/agent-skills

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. Shows which VERSION slots are currently claimed by open PRs, which sibling Conductor workspaces have WIP work likely to ship soon, and what slot /ship would pick next. No mutations — just a snapshot. Use when asked to "landing report", "what's in the queue", "show me open PRs", or "which version do I claim next". (gstack)

Biznomad/agent-skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

Biznomad/agent-skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

Biznomad/agent-skills

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

Biznomad/agent-skills

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

Biznomad/agent-skills

Still-to-video conversion guide: model selection, motion prompting, and camera movement. Covers Wan 2.5 i2v, Seedance, Fabric, Grok Video with when to use each. Use for: animating images, creating video from stills, adding motion, product animations. Triggers: image to video, i2v, animate image, still to video, add motion to image, image animation, photo to video, animate still, wan i2v, image2video, bring image to life, animate photo, motion from image

Biznomad/agent-skills

>- The Landing Page Audit skill performs comprehensive evaluations of post-click experiences, combining technical performance analysis with conversion rate optimization (CRO) assessment.

Biznomad/agent-skills

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

Biznomad/agent-skills

Optimize landing pages for higher conversion rates using proven frameworks and design patterns. Use when designing, reviewing, or improving landing pages, hero sections, pricing pages, CTAs, or when the user asks about conversion optimization.

Biznomad/agent-skills

Building promotion cases, brag documents, tracking wins, and self-advocacy for career advancement. Use when preparing for promotions, documenting accomplishments, or building your case for advancement.

Biznomad/agent-skills

Best practices for Remotion - Video creation in React

Biznomad/agent-skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

Biznomad/agent-skills

Produce programmable videos with Remotion using scene planning, asset orchestration, and validation gates for automated, brand-consistent video content.

Biznomad/agent-skills

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

相关技能