# Freelance Pitch

> ALWAYS invoke when the user wants to draft a freelance proposal for a single gig — by rank from /freelance-search, by URL, or picked from a list. Triggers: "freelance pitch", "draft proposal", "pitch this gig", "proposal for gig 3".

- **Type:** Skill
- **Install:** `agentstack add skill-doctormozg-claude-pipelines-freelance-pitch`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [DoctorMozg](https://agentstack.voostack.com/s/doctormozg)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [DoctorMozg](https://github.com/DoctorMozg)
- **Source:** https://github.com/DoctorMozg/claude-pipelines/tree/master/plugins/mz-job-outreach/skills/freelance-pitch

## Install

```sh
agentstack add skill-doctormozg-claude-pipelines-freelance-pitch
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Freelance Pitch

## Overview

You generate a single grounded freelance proposal for a selected gig. The gig may be referenced by rank (against the latest `/freelance-search` run), by URL (looked up in the latest run; if absent, WebFetched off-pipeline with a warning), or picked interactively from a list of the top-10 scored gigs.

The proposal is a markdown file at `.mz/outreach//proposals/.md`. Word cap: 350. Hard. Pricing and milestones must be grounded in verbatim text from the gig or the strategist's rate floor — no fabrication.

## When to Use

Invoke when the user wants to draft a proposal for one specific freelance gig. Trigger phrases: "draft a proposal", "pitch this gig", "freelance pitch", "proposal for gig ", "proposal for ".

### When NOT to use

- The user wants to find gigs — use `/freelance-search` instead.
- The user wants a salaried cover letter — use `/job-search` or the copywrite skill.
- The user has no scored runs and no gig URL — the pipeline asks for a URL or aborts.

## Input

- `$ARGUMENTS` — optional, one of:
  - An integer rank (e.g. `3`) → resolve against the latest `/scored.json`.
  - A URL → look up in the latest `scored.json`; if not found, WebFetch with a warning.
  - Empty → interactive picker.

## Directory Structure

- **State** — `.mz/task//state.md`.
- **Output** — when resolving against an existing freelance-search run: `.mz/outreach//proposals/.md`. When operating off-pipeline (URL with no prior run): `.mz/outreach/_freelance_pitch_/proposals/.md`.

## Core Process

### Phase Overview

| #   | Phase                         | Agent(s)                          | Details                       |
| --- | ----------------------------- | --------------------------------- | ----------------------------- |
| 0   | Resolve gig (rank/URL/picker) | — (orchestrator, AskUserQuestion) | `phases/resolve_and_pitch.md` |
| 1   | Read CV + gig + tone pick     | — (orchestrator, AskUserQuestion) | `phases/resolve_and_pitch.md` |
| 1.5 | Tone preference approval      | — (orchestrator)                  | `phases/resolve_and_pitch.md` |
| 2   | Generate proposal             | `freelance-proposal-writer`       | `phases/resolve_and_pitch.md` |
| 3   | Proposal review + edit loop   | — (orchestrator, AskUserQuestion) | `phases/resolve_and_pitch.md` |
| 4   | Write final proposal file     | — (orchestrator)                  | `phases/resolve_and_pitch.md` |

Read the phase file when reaching Phase 0.

## Techniques

Delegated to phase file.

## Common Rationalizations

N/A — orchestration skill.

## Red Flags

- You generated a proposal without a CV — proposal-writer cannot ground the credibility hook.
- You allowed a milestone with no verbatim grounding from `gig.project_scope_raw`.
- You let a pricing figure stand that does not trace to `gig.budget_range_raw` or `strategy.rate_floor`.
- The final proposal contains any banned phrase from the proposal-writer's list.
- The proposal exceeds 350 words.
- You skipped the user approval gate at Phase 3.

## Verification

Before completing, output a visible block showing: gig title, gig URL, source, output file path, word count, engagement type assumed, and a one-line excerpt of the opener. Confirm the proposal file exists on disk.

______________________________________________________________________

## Phase 0 entry

Parse `$ARGUMENTS`:

- Integer (e.g. `3`) → `rank_arg`.
- URL (starts with `http://` or `https://`) → `url_arg`.
- `personality:off` token (anywhere in `$ARGUMENTS`) → `personality_mode = off` (default `on`); disables the Phase 1.6 reader-style read so proposals use neutral structure.
- Empty (no rank or URL) → interactive picker.

Discover the most recent freelance-search run:

```bash
latest_run=$(ls -dt .mz/outreach/*freelance_search_* 2>/dev/null | head -n 1)
```

Branching:

- **`rank_arg` set** → require `latest_run`. If absent, AskUserQuestion: "No prior /freelance-search run found. Provide a gig URL, or **Cancel**."
- **`url_arg` set** → if `latest_run` exists, look up the URL in `latest_run/scored.json`. If found, use the scored record. If not found, WebFetch the URL and treat as off-pipeline (warn: no prior scoring).
- **Empty** → if `latest_run` exists, AskUserQuestion with a single-select menu of the top-10 scored gigs (label = `#  —  (score )`) plus an "Other URL" option. If no `latest_run`, AskUserQuestion demands a URL or aborts.

Set `task_name = _freelance_pitch_`. Set `run_dir`:

- If gig came from `latest_run`'s `scored.json`: `run_dir = latest_run` (proposals nested under existing run).
- If gig is off-pipeline (URL with no prior scoring): `run_dir = .mz/outreach/` (new sibling directory).

```bash
mkdir -p .mz/task/
mkdir -p /proposals
```

Read `phases/resolve_and_pitch.md` for the rest.

## State Management

State persists to `.mz/task//state.md`. Schema is **v2**: the file's first line is `schema_version: 2`, and alongside the skill's existing `Status` / `Phase` / `Started` keys it carries `phase_complete` (boolean) and `what_remains` (YAML list of strings). Set `phase_complete: false` on phase entry and `true` once the phase's artifacts are written and its gates pass; refresh `what_remains` on every phase transition; `what_remains` MUST be `[]` when `Status: complete`. On reading a `schema_version: 1` or unversioned file, add the missing keys, set `schema_version: 2`, and log the upgrade.

## Error Handling

- Off-pipeline WebFetch fails: AskUserQuestion to retry the URL or Cancel.
- proposal-writer returns `STATUS: BLOCKED` (all milestones ungrounded): emit a chat block explaining the scope is too vague to produce a grounded proposal; offer to re-run with a different gig.
- proposal-writer returns `STATUS: DONE_WITH_CONCERNS`: show concerns in the Phase 3 review gate so the user can accept or request a regenerate.

## Resume Support

Phase 0 always re-resolves the gig (cheap). Phases 2-4 are not resumed — if interrupted, re-run `/freelance-pitch` with the same args.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [DoctorMozg](https://github.com/DoctorMozg)
- **Source:** [DoctorMozg/claude-pipelines](https://github.com/DoctorMozg/claude-pipelines)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-doctormozg-claude-pipelines-freelance-pitch
- Seller: https://agentstack.voostack.com/s/doctormozg
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.