Formhug

FormHug 技能

用于使用 FormHug 的 Agent 技能——连接到其 MCP 服务、构建优质表单并采用推荐模式。遵循 Agent Skills 开放标准，因此适用于任何能够读取 SKILL.md 的 Agent：Claude Code、Codex CLI、Cursor、Windsurf、Claude Desktop、OpenClaw、Hermes 等。

MCP 服务本身（https://formhug.ai/mcp）提供了自己的参考资源（formhug://guide、formhug://field-types 等），涵盖工具用法。本仓库通过技能对这些资源进行补充：Agent 会根据触发条件主动启用这些技能，包括安装流程、工作流指南和有主见的最佳实践——这类内容以程序化技能的形式提供，比作为按需查阅的参考文档更合适。

可用技能

技能	功能
setup-formhug-mcp	配置当前 Agent 以连接 https://formhug.ai/mcp。自动选择 OAuth（本地 Agent）或 Personal Access Token（远程/聊天 Agent），为相应 Agent 写入正确配置，并通过 get_me 验证。
migrate-form-to-formhug	将其他平台上的现有表单或文档（Word/PDF/Excel/截图）重建到 FormHug 中。采用先盘点的工作流，提供字段类型映射表，并在创建后进行验证。
analyze-formhug-entries	分析表单提交内容：完整分页、api_code→标签解码、按类型聚合（NPS、likert、checkbox），以及如实报告的规则。
audit-formhug-form	根据固定清单（字段类型适配性、必填项规范、结构、设置、隐私）审核现有表单，并在正式表单上安全地应用已批准的修复。
formhug-survey-methodology	调查设计方法——问题措辞、量表设计、结构、答复质量保障措施——并映射到实现各模式的 FormHug 字段。

安装

推荐使用 Vercel Labs 的 skills CLI——它会检测已安装的 Agent，并将技能复制到各自对应的位置：

npx skills add formhug/skills

仅安装指定技能，或仅安装到指定 Agent：

npx skills add formhug/skills --skill setup-formhug-mcp
npx skills add formhug/skills -a claude-code -a cursor

手动安装

如果不想使用 CLI，可以将技能目录复制到 Agent 的技能目录中。路径因 Agent 而异：

Agent	技能目录
Claude Code	~/.claude/skills/（用户级）或 .claude/skills/（项目级）
Codex CLI	~/.codex/skills/
Cursor	~/.cursor/skills/
Gemini CLI	~/.gemini/skills/
OpenClaw	通过 clawhub install <skill> 安装

git clone https://github.com/formhug/skills.git
cp -r skills/skills/setup-formhug-mcp ~/.claude/skills/

用法

安装后，当 Agent 识别到匹配的请求时，技能会自动启用（每个技能都会在其 frontmatter 中声明触发条件）。支持将技能作为斜杠命令使用的 Agent，也可以直接调用技能，例如 /setup-formhug-mcp。

仓库结构

skills/
  <skill-name>/
    SKILL.md          # frontmatter (name, description) + instructions
    references/       # optional — files the skill pulls in on demand
    scripts/          # optional — executable helpers

每个技能都是一个独立目录。Agent 会先加载 SKILL.md；其余内容都在该文件中引用，并会按需读取（渐进式披露）。

适合收录在这里的技能类型

• 设置 / 集成 — 将 Agent 连接到 FormHug（setup-formhug-mcp）
• 工作流指南 — 由 Agent 驱动、具有明确主张的流程（例如“根据描述设计一个注册表单”“审核现有表单的提交内容”）
• 最佳实践 — 将 Agent 使用 FormHug 工具时应遵循的约定编纂成文（字段命名、评分标准、主题选择、Webhook 模式）

Agent 只有在已经决定要做什么之后才需要的参考资料（字段类型目录、主题令牌、错误代码表），通常应放在 MCP 服务的资源中，而不是这里。