Formhug

FormHug スキル

FormHug を使うためのエージェントスキルです。MCP サーバーへの接続、優れたフォームの作成、推奨パターンの適用を支援します。Agent Skills のオープン標準に準拠しているため、SKILL.md を読み込めるあらゆるエージェントで利用できます。Claude Code、Codex CLI、Cursor、Windsurf、Claude Desktop、OpenClaw、Hermes などに対応しています。

MCP サーバー自体（https://formhug.ai/mcp）には、ツールの使用方法を説明するリファレンスリソース（formhug://guide、formhug://field-types、…）が付属しています。このリポジトリでは、それらを補完するスキルを提供します。インストール手順、ワークフローガイド、独自のベストプラクティスなど、必要に応じて参照するドキュメントよりも手順型のスキルとして提供するのに適した内容を、エージェントがトリガーに応じて自発的に有効化します。

利用可能なスキル

スキル	内容
setup-formhug-mcp	現在のエージェントが https://formhug.ai/mcp と通信できるように設定します。OAuth（ローカルエージェント）か Personal Access Token（リモート／チャットエージェント）を自動的に選択し、エージェントに適した設定を書き込み、get_me で確認します。
migrate-form-to-formhug	別のプラットフォームやドキュメント（Word/PDF/Excel/スクリーンショット）にある既存のフォームを FormHug で再作成します。項目の棚卸しから始めるワークフローで、フィールドタイプの対応表と作成後の確認が含まれます。
analyze-formhug-entries	フォームの送信内容を分析します。完全なページネーション、api_code からラベルへのデコード、タイプ別の集計（NPS、リッカート尺度、チェックボックス）、誠実な報告のルールに対応しています。
audit-formhug-form	固定チェックリスト（フィールドタイプの適合性、必須設定の運用、構成、設定、プライバシー）に照らして既存のフォームを確認し、承認された修正を運用中のフォームに安全に適用します。
formhug-survey-methodology	調査設計の方法論です。質問の文言、尺度の設計、構成、回答品質を守る対策を扱い、それぞれのパターンを実装する FormHug のフィールドに対応付けます。

インストール

推奨される方法は、Vercel Labs の skills CLI を使うことです。インストール済みのエージェントを検出し、それぞれに適した場所へスキルをコピーします。

npx skills add formhug/skills

特定のスキルのみ、または特定のエージェントにのみインストールすることもできます。

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

手動インストール

CLI を使わない場合は、スキルのディレクトリをエージェントのスキル用ディレクトリにコピーしてください。パスはエージェントによって異なります。

エージェント	スキル用ディレクトリ
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/

使い方

インストール後、エージェントが該当するリクエストを認識すると、スキルが自動的に有効になります（各スキルのトリガーはフロントマターで定義されています）。スキルをスラッシュコマンドとして公開するエージェントでは、たとえば /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

各スキルは自己完結型のディレクトリです。エージェントは最初に SKILL.md だけを読み込み、その他の内容はその中から参照され、必要に応じて読み込まれます（段階的な開示）。

ここに含めるスキルの種類

• セットアップ／インテグレーション — エージェントを FormHug に接続する手順（setup-formhug-mcp）
• ワークフローガイド — エージェント主導の、特定の方針に基づくフロー（例：「説明から登録フォームを設計する」「既存フォームの回答を監査する」）
• ベストプラクティス — FormHug のツールを使用する際にエージェントが従うべき、体系化された規約（フィールド名、採点基準、テーマの選択、Webhook のパターン）

エージェントが実行内容を決定した後で初めて必要となるリファレンス資料（フィールドタイプの一覧、テーマトークン、エラーコード一覧など）は、通常、ここではなく MCP サーバーのリソースに含めます。