mcpField
U
upwork-proposal

upwork-proposal

github.com/mumerrazzaqマーケティング・グロース5211 回インストール42 週間前に更新
リポジトリ

upwork-proposal について

upwork-proposalは、Upworkの求人情報をもとにフリーランサーが提案文を作成するスキルです。要件を抽出してユーザーのスキルと照合し、構成に沿った全文と短縮版を生成します。

主な機能

  1. 01求人要件と隠れた指示の抽出
  2. 02求人内容とユーザーのスキルの照合
  3. 037部構成に沿った提案文の作成
  4. 04全文と短縮版の生成
  5. 05提示情報に応じた経験・料金・日程の反映

活用シーン

  1. 01新着のUpwork求人への応募準備
  2. 02クライアントの要望に合わせた提案文の作成
  3. 03求人内容から関連する過去の実績を整理
  4. 04長い提案文の短縮版の作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/mumerrazzaq/claude-code-skills-lab --skill upwork-proposal

インストール後、Claude Code で/upwork-proposalを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
engineering-methodology.md
examples.md
proposal-structure.md
standout-strategies.md
user-profile.md

詳細

Upwork 提案スキル

AI 提案の氾濫を乗り越え、実際に返信を得られる提案を作成します。

解決する課題

クライアントには、ロボットのようで曖昧、しかも「採用ご担当者様」で始まる、どれも同じように聞こえる提案が50件以上届きます。ありきたりなAI文面はすぐに見抜かれます。このスキルでは、人間らしく、具体的で、返信する価値のある提案を作成します。

主な統計(2025-2026)

指標値
求人あたりの平均提案件数20-50
返信率8-30%
採用率約5%(20件に1件)
AIと人間のハイブリッドによる採用率純粋なAIまたは完全な手作業より48%高い
最適な提案の長さ150-250語
最初の1時間以内の応募返信率が48%高い

ワークフロー

User pastes job → Extract requirements → Match to user skills → Generate proposal + shorter version

必須入力

入力説明
job_descriptionUpwork の求人投稿(ユーザーが貼り付けます)

任意入力(関連する場合に確認)

入力確認するタイミング
relevant_experience求人が過去の特定のプロジェクトに合致する場合
rate/pricingユーザーが具体的な料金を含めたい場合
availability求人に緊急性やスケジュールの記載がある場合
special_angleユーザーが課題に対する独自の見解を持っている場合

7つのパートで構成する公式(返信率24%以上)

詳細は references/proposal-structure.md を参照してください。概要:

パート長さ目的
つかみ25語クライアント名と具体的な課題
関連性50-75語成果を伴う類似経験
解決策50-75語箇条書きの納品物
実績30-50語数値を含む過去のプロジェクト1~2件
スケジュール15-25語曖昧な表現ではなく具体的な日付
費用10-15語適切な場合は明確な料金
CTA15-20語具体的な次のステップを1つ

合計:195-285語(300語未満が理想)

AI 生成文のような文章を避けるルール

詳しくは references/standout-strategies.md を参照してください。重要なルール:

することしないこと
「こんにちは」から始めるか、クライアントの名前を使う「採用ご担当者様」や「お元気でお過ごしのことと思います」
求人投稿の具体的な内容を2つ挙げる「この役割に最適です」のような一般的な表現
数字を使う:「類似プロジェクト23件」、「月12,000ドルの成果」「豊富な経験」のような曖昧な主張
自然な短縮形:「I'll」、「you're」、「can't」ロボットのような表現:「喜んで対応させていただきます」
絵文字は最大1つ(あいさつに👋)絵文字を複数使う、またはまったく使わない
具体的なスケジュール:「12月15日」「できるだけ早く」のような曖昧な表現
解決策への取り組み方から始める経歴から始める

テスト指示の検出

クライアントはスパムをふるい落とすため、「冒頭に HOWDY と書いてください」のようなテストを加えることがあります。求人投稿に次の指示がないか、必ず確認してください。

  • 含めるべき特定の言葉
  • 回答すべき質問
  • 投稿の中ほどや最後に隠された指示

見つかった場合は、最優先で従ってください。

出力形式

ユーザーは短いバージョンをよく求めるため、常に2つのバージョンを提示してください。

## Proposal (Ready to Submit)

[Full proposal following 7-part formula]

## Shorter Version

[Condensed 100-150 word version]

## One-Liner (For quick reference)

[Single sentence pitch]

## Notes

- [Relevant past projects to mention]
- [Questions to ask client]
- [Red flags if any]

ユーザーの文体の好み

分析した Upwork での12件の会話に基づきます。

  1. あいさつ:「Hey there 👋」または「Hi there 👋」
  2. トーン:自然で、人間らしく、会話的
  3. 構成:解決策を先に示し、その後に経験を述べる
  4. 長さ:常に短縮を希望するため、簡潔な文章から始める
  5. 誠実さ:実績を誇張せず、これから学ぶ分野にも触れる
  6. 技術関連の言及:n8n、Python、AI エージェント、Google Workspace

ユーザーのスキルのアピール方法

references/user-profile.md を参照してください。概要:

強調する項目:

  • n8n によるワークフロー自動化
  • AI エージェント / Agentic AI(PIAIC 認定)
  • Python、FastAPI
  • API 連携
  • Google Workspace の自動化
  • WhatsApp Business API

正直に伝える項目:

  • React、Node.js(学習中)
  • Make/Zapier(概念は理解しているが、実務経験はない)

エンジニアリング手法(信頼の証)

ユーザーは**仕様駆動開発(SDD)とテスト駆動開発(TDD)**に取り組んでいます。

言及するタイミング: 品質や信頼性が重要なプロジェクトに限ります。

  • 複数の連携機能を含む複雑な自動化
  • 長期または継続中のプロジェクト
  • 「信頼できる」「本番環境対応」「保守しやすい」と言及するクライアント
  • 予算が高めのプロジェクト(500 ドル以上)
  • 以前に別のフリーランサーとの仕事で問題を経験したクライアント

言及しないケース: 簡単な単発タスク、軽微な修正、低予算の案件。

納品物(リポジトリ内):

  • specs/ - 要件と設計の仕様書(フェーズごと)
  • tests/ - Pytest テストスイート(コードを書く前に作成)
  • docs/ADRs/ - アーキテクチャ決定記録
  • 明確な構成で、コード自体が説明となるコード

自然な表現方法:

I follow spec-driven development — I'll document requirements first,
write tests, then implement. You'll get working code plus specs and
tests in the repo, not just "it works on my machine."

短いバージョン:

I write specs and tests first, so you get reliable, documented code.

一文で(関連する場合):

All deliverables include specs, tests, and documentation in the repo.

詳しくは references/engineering-methodology.md をご覧ください。

変換例

一般的なAIの凡庸な文章:

Dear Hiring Manager,
I hope this message finds you well. I am writing to express my keen interest in your project. With my extensive experience in automation and workflow development, I am confident I can deliver exceptional results. I have worked on numerous similar projects and would be delighted to discuss further.

採用につながる提案文:

Hey there 👋

I can help you automate your Google Sheets → AI → PDF → Email workflow in n8n.

Here's the plan:
- Connect Google Sheets with scheduled triggers (twice weekly)
- Pass data to ChatGPT/DeepSeek for processing
- Generate formatted PDF (via API or Google Docs conversion)
- Auto-send via Gmail

I recently built a similar workflow connecting Sheets with ChatGPT for automated reporting — happy to share details.

When would you like to kick off?

出力前のチェックリスト

  • 求人情報全体(非表示のテスト指示を含む)を読んだ
  • 対応すべき具体的な要件を2つ以上抽出した
  • 250語以内である
  • パーソナライズされた導入で始めている(「Dear Hiring Manager」ではない)
  • 具体的なアプローチ/解決策を含めている
  • 具体的な実績(数値、過去のプロジェクト)を示している
  • 最後に明確なCTAがある
  • 短いバージョンを用意している
  • 自然な口調で、短縮形を使っている
  • 過剰なアピールや曖昧な主張がない

コメント