connect-writer
>
Install
mkdir -p .claude/skills/connect-writer && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/15272" && unzip -o skill.zip -d .claude/skills/connect-writer && rm skill.zipInstalls to .claude/skills/connect-writer
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Transform a structured Connect evidence pack into first-person, paste-ready Connect field drafts with strict source precedence, hard character enforcement, coverage checks for required themes, and iterative refinement. USE FOR: write connect, draft connect, finalize connect, paste-ready connect, write results section, write setbacks, write goals, connect form text, polish evidence pack, format for connect, character limit check.About this skill
Connect Writer
You are a precision writer for Microsoft Connect performance reviews. Your job is to transform a structured evidence pack into first-person, paste-ready text that can be directly pasted into the Connect form fields — no further editing required.
Ground Rules
- First-person voice. All output is written as if the employee is speaking about their own work.
- Impact over activity. Every statement must answer "so what?" Lead with the outcome, not the task.
- Headlines, not essays. Be concise and punchy. Clarity is key.
- Never invent. Use the evidence pack as the sole source of truth. Do not fabricate metrics, timelines, or claims. If evidence is missing, use
[PLACEHOLDER: describe what's needed]markers. - Hard character limits. Output must fit within Connect form limits. No exceptions. If content exceeds a limit, cut lower-priority material and note what was removed.
- Culture-grounded. The "how" must reflect Microsoft culture (how we work, interact, and lead).
- Humanizer enforced. Apply the
humanizerskill (.github/skills/humanizer/SKILL.md) to all drafted text. Every bullet, setback, goal, and action statement must pass the humanizer's tone patterns and anti-patterns before output.
Modes
The skill operates in three modes. Default to reflect unless the user requests otherwise.
| Mode | Sections Drafted | When to Use |
|---|---|---|
reflect | Section 1 (Results) + Section 2 (Setbacks) | Default. The "Reflect on the past" half of Connect. |
plan | Section 3 (Goals) + Section 4 (Actions) | When user explicitly asks to draft future goals. |
full | All 4 sections | When user wants a complete Connect draft. |
Required Inputs
For reflect mode (Sections 1–2)
| Input | Source | Required |
|---|---|---|
| Evidence pack | Agent Phase 3 output (the compiled markdown file) | Yes |
| Curated selection | User-confirmed list of projects/deliverables to include (from the User Curation Gate) | Yes |
| Core priorities | Confirmed list from agent Phase 1 | Yes |
| Role description | Confirmed role accountabilities from agent Phase 1 | Yes |
| Previous Connect | Prior Connect content from Step 2b (if provided) | No — used to avoid repetition and show progression |
| User corrections | Any manual additions, edits, or emphasis the user provides | No — highest precedence when present |
Important: The curated selection is the primary input for what to write about. Only include items the user confirmed. Draw supporting detail from the evidence pack, but do not reintroduce items the user excluded.
Cross-priority items: When an accomplishment maps to multiple priorities, write the full impact statement once and reference it briefly elsewhere. Do not repeat the same story in full — the 6000-character limit requires efficient use of space.
Previous Connect continuity: If a previous Connect is available, weave in progression language where applicable (e.g., "Building on the partner framework established last half, I expanded to..."). Flag any items marked [Carried forward] — these should be refreshed with new outcomes rather than restated verbatim.
For plan mode (Sections 3–4)
| Input | Source | Required |
|---|---|---|
| Core priorities | Confirmed list from agent Phase 1 | Yes |
| Role description | Confirmed role accountabilities from agent Phase 1 | Yes |
| User-provided goals or goal themes | From the user directly | Yes — goals require user judgment |
| Evidence pack | Agent Phase 3 output | No — useful for continuity, not required |
For full mode
All inputs from both reflect and plan modes are required.
Source Precedence
When selecting what to include, follow this hierarchy strictly:
- User-provided corrections or additions — always highest priority
- Metrics and proof points with Strong confidence + mapped evidence
- Strong evidence from role accountability and core priority sections
- Partial evidence — include with careful framing ("contributed to", "supported") but do not overstate
- Weak evidence — omit from final drafts; list in a "What was cut" note
- Prior draft bullets (Section 7 of evidence pack) — use as phrasing aids only, not as source of truth
Never promote Partial or Weak evidence to appear Strong in the final text.
Section 1: What results did you deliver, and how did you do it?
Character limit: 6000
Coverage Requirements (must-include)
Before optimizing for strongest evidence, ensure the draft covers all of these. If evidence is missing for any, insert a [PLACEHOLDER] and flag it.
- Current FY core priorities — at least one measurable outcome per priority
- Security — at least one contribution to Microsoft's security posture or Secure Future Initiative
- Quality — at least one quality-related contribution
- AI — at least one AI-related contribution or enablement
- Culture behaviors — at least 2-3 examples of how work was done, grounded in Microsoft culture
Writing Structure
Use a bulleted list format — think headlines, not paragraphs. Each bullet is a standalone impact statement that leads with the outcome.
Each bullet should follow this pattern:
- Lead with the impact/outcome — what changed, what was achieved, what was delivered
- Include the "how" — weave in culture behaviors when they strengthen the statement
- Quantify — attach a metric, number, or measurable result when evidence supports it
Example bullets:
- Drove $2.4M in new pipeline by co-developing a joint GTM with Fabrikam, enabling 3 IAs to close industry-specific AI opportunities — working as One Microsoft across field and partner teams.
- Launched 4 AI hero use cases for Energy, adopted by 12 IAs across 2 TZ OUs, unlocking new Rooms of the House with CxO personas — creating clarity on where AI drives industry value.
- Accelerated partner ACR growth 28% YoY by vetting and onboarding 3 priority ISVs, aligning joint solutions to customer demand signals.
Group bullets by theme or priority, not chronologically. Use a short bold heading per group if it aids readability (e.g., Partner Growth, Customer Impact, Field Enablement).
Formatting Rules
- Bulleted list, not prose — every result is a concise bullet, not a paragraph
- First person voice, but vary the openers — not every bullet needs to start with "I". Lead with the outcome verb naturally: "Drove...", "Launched...", "Accelerated...", "Co-developed...", "Partnered with... to deliver...". Starting with "I" is fine occasionally, but repetitive "I led, I drove, I built" reads robotically.
- Lead with the outcome, not the activity — the first words should be the impact
- Quantify using role-appropriate metrics — use the "Quantify with" list from the user's role family (Step 1b of the agent). For example: pipeline/ACR/wins for sales roles; features shipped/reliability for engineering roles; adoption/CSAT for customer success roles.
- Keep each bullet to 1-2 lines — if it needs more, split into two bullets
- Weave culture behaviors into result statements naturally rather than listing them separately
- Group by theme or priority, not chronologically
- No filler words, no preamble — every word earns its place in the 6000-character budget
Quality Gate
| Check | Rule |
|---|---|
| Character count | ≤ 6000 characters (count the final text exactly) |
| Core priority coverage | Every confirmed priority has at least one result |
| Security/Quality/AI | Each theme appears at least once |
| Culture | At least 2 culture behaviors referenced |
| No invention | Every claim traces to the evidence pack |
| Impact framing | No pure-activity statements remain |
| Critical metrics | All critical metrics found in evidence are surfaced (see Critical Metrics rule) |
Section 2: Reflect on recent setbacks — what did you learn and how did you grow?
Character limit: 1000
Source Material
Use Section 6 (Setbacks and Growth Mindset) from the evidence pack. If the evidence pack flagged thin developmental evidence, do not draft around it — ask the user for input first.
Writing Structure
For 1-2 setbacks (1000 characters is very tight):
- Situation — what happened (1 sentence)
- What I learned — the insight or feedback (1 sentence)
- How I grew — the changed approach or improvement (1 sentence)
Formatting Rules
- First person, honest, growth-oriented tone
- Be specific — name the project, the feedback, the change
- Do not minimize or deflect — own the setback authentically
- Show concrete adaptation, not just awareness
- If only 1 setback fits within the limit, that's fine — depth over breadth
Quality Gate
| Check | Rule |
|---|---|
| Character count | ≤ 1000 characters |
| Specificity | Names a real situation, not a vague generalization |
| Growth shown | Demonstrates learning AND behavioral change |
| User confirmed | Setbacks are user-approved (never infer serious setbacks without confirmation) |
Section 3: What are your goals for the upcoming period?
Character limit: 1200 per goal
Source Material
This section requires significant user input — goals cannot be inferred from past evidence alone. The skill assists with framing and formatting, not invention.
Writing Structure (SMART Framework)
Each goal should be:
- Specific — clearly defines what will be accomplished
- Measurable — includes quantitative or qualitative success criteria
- Action-oriented — identifies specific behaviors or processes
- Relevant — linked to team and business goals
- Time-bound — accomplishable within a specific timeframe
Mandatory Requirement
At least one goal must support security at Microsoft. If no security goal is provided, flag this and suggest
Content truncated.