Docs & writing
16,632 rows, by stacks then stars
3,030 of these skill files have been read, by 1,951 distinct authors, and what they tell an agent counted. What Docs & writing authors agree on, and what they forbid
SkillMedev/skills/skills/jira-ticket-writer Skill
5★ repoWrites ready-to-build Jira stories with user-story summaries, Given/When/Then acceptance criteria, subtasks, and story-point guidance, checked against INVEST and a Definition of Ready. Use when someone asks "write a Jira ticket for this", "turn these meeting notes into a story", "are these acceptance criteria testable", "should I split this story", or "how many points is this". Do NOT use for configuring Linear teams, cycles, labels, or triage workflows - use linear-workflow instead. For deciding what fits in the sprint, use sprint-planning.
The same file is in 2 other repositories
SkillMedev/skills/skills/job-application Skill
5★ repoTailors a resume and writes a cover letter for one specific job description - mirroring JD keywords for ATS parsing, reordering bullets by relevance, quantifying impact, and reporting which JD keywords matched and which are missing. Use when someone asks "tailor my resume to this job", "write a cover letter for this posting", "will my resume pass the ATS", or shares a job description alongside their resume. Do NOT use for writing or restructuring a resume without a target job - use resume-writer instead; for critique of an existing resume, use resume-reviewer.
The same file is in 1 other repository
SkillMedev/skills/skills/job-description-writer Skill
5★ repoDraft an inclusive, role-relevant, level-calibrated job posting from a hiring manager's role brief. Use when an employer is writing or revising a job description, JD, or job posting - you have a role brief, leveling rubric, or comp band and need outcome-based requirements, plain compensation/logistics, and inclusive tone. Do NOT use when tailoring a candidate's resume or cover letter to a posting - use job-application instead.
The same file is in 1 other repository
SkillMedev/skills/skills/kb-article-writer Skill
5★ repoTurns a resolved support ticket into a clear, searchable knowledge-base or help center article. Use when someone asks "write a KB article from this resolved ticket", "turn these resolved tickets into help center articles", or "write an internal knowledge base article for our support agents" - converting ticket resolutions into self-service documentation that deflects future tickets. Do NOT use for writing user-facing how-to guides from scratch - use help-documentation instead.
The same file is in 1 other repository
SkillMedev/skills/skills/landing-page-cro Skill
5★ repoImproves an existing landing page's conversion rate through evidence-first CRO - audit heatmaps and recordings, write structured hypotheses, prioritize with ICE scoring, and run one-variable tests to statistical significance. Use when someone asks "why isn't my landing page converting", "audit this page before we scale spend", "which A/B test should we run first", or after a CVR drop or ahead of a paid-traffic push. Do NOT use for writing a new landing page from scratch - use landing-page-copy instead. Do NOT use for auditing the ad accounts sending the traffic - use paid-acquisition-audit instead. Do NOT use for reading the results of a finished experiment - use ab-test-analyzer instead.
The same file is in 2 other repositories
SkillMedev/skills/skills/launch-day-runbook Skill
5★ repoUse when you are running an actual launch day in real time across channels. Triggers on "launch day runbook", "we launch tomorrow", "Product Hunt launch day plan", "hour by hour launch schedule", "who does what on launch day", "PH / Hacker News / Twitter / email sequencing", "launch day checklist", "our launch is going sideways", "contingency if we get rate-limited / Show HN flops / site goes down". Turns the plan into a minute-by-minute war room. Do NOT use when you are still picking the launch date, beats, or channel mix - use [[launch-plan-sequencer]] for the calendar first; this is the execution companion that runs the day it lands on.
The same file is in 1 other repository
SkillMedev/skills/skills/lesson-plan-builder Skill
5★ repoBuilds a complete single-lesson plan - measurable objective, timed four-part arc (hook, direct instruction, guided practice, closure), a formative check with a proceed/re-teach rule, and differentiation notes - clear enough that a substitute could run it. Use when someone asks "write a lesson plan for...", "plan a 50-minute class on photosynthesis", "how should I structure tomorrow's lesson", or "turn this standard into a lesson". Do NOT use for sequencing a multi-week unit or full course - use curriculum-mapper instead; for deep per-learner adaptation of an existing lesson, use differentiated-instruction; for writing the quiz itself, use quiz-generator.
The same file is in 2 other repositories
SkillMedev/skills/skills/linear-workflow Skill
5★ repoConfigures a Linear team end to end - team structure, minimal workflow states, cycles, a small label taxonomy, a daily triage rotation, and priority SLAs with breach views. Use when someone asks "set up Linear for my team", "how should we structure teams and labels in Linear", "our Linear backlog is a mess", or "how do we handle inbound bugs in Linear". Do NOT use for writing the tickets themselves - acceptance criteria, story points, Definition of Ready - use jira-ticket-writer instead (its ticket anatomy applies to Linear issues too). For deciding sprint scope and capacity, use sprint-planning.
The same file is in 1 other repository
SkillMedev/skills/skills/linkedin-post-writer Skill
5★ repoWrite LinkedIn posts built for the feed - a hook that survives the two-line truncation, scannable one-idea-per-line structure, a comment-bait close, and first-hour engagement moves. Use when someone asks "write a LinkedIn post about this", "punch up my LinkedIn hook", "why did my post get no reach", or "turn this win into a LinkedIn post". Do NOT use for Twitter/X threads - use tweet-thread-builder instead. Do NOT use for scheduling across a monthly calendar - use social-content-calendar instead.
The same file is in 3 other repositories
SkillMedev/skills/skills/listing-description-writer Skill
5★ repoWrites MLS and portal listing copy that sells the property - lead with the differentiator, translate features into benefits, specifics over adjectives, platform length limits, and a fair-housing-safe banned-claims list. Use when an agent says "write my listing description", "make this MLS copy better", "describe this house for Zillow", or "punch up my listing remarks". Do NOT use for e-commerce product listings - use product-description-writer instead, or amazon-listing-optimizer for Amazon listings.
The same file is in 1 other repository
SkillMedev/skills/skills/llm-evaluation Skill
5★ repoBuilds evaluation harnesses for LLM products - golden datasets, deterministic checks, calibrated LLM-as-judge rubrics, and CI regression gates that turn "seems good" into a tracked number. Use when someone asks "how do I know this prompt change didn't break anything", "set up evals for my RAG pipeline", "is LLM-as-judge reliable", "why did quality drop after the model swap", or is shipping an LLM feature with no quality measurement. Do NOT use for classical ML model reporting (precision/recall, ROC curves, confusion matrices on trained classifiers) - use model-evaluation-report instead; do NOT use for analyzing online A/B experiments - use ab-test-analyzer instead.
The same file is in 1 other repository
SkillMedev/skills/skills/localization-guide Skill
5★ repoAdapts English content for a target language and region - swapping idioms, setting the right formality register, replacing cultural references, converting dates, units, and currency - and delivers the localized text with a notes column explaining each adaptation and flagging what needs a native reviewer. Use when someone asks "localize this copy for the Japanese market", "adapt our marketing copy for the Mexican market", "make this translation sound native instead of literal", or a literal translation reads foreign, stiff, or risky. Do NOT use for auditing in-product UI text quality - use ux-writing-audit instead.
SkillMedev/skills/skills/logo-brief-writer Skill
5★ repoWrites a complete creative brief for a logo or identity project - business context, a three-adjective personality axis, deliverables and constraints, competitive territory, rounds and timeline, and concrete success criteria. Use when someone asks "write a logo brief", "brief a designer for our rebrand", "what do I send the identity studio", or is kicking off a brand identity engagement. Do NOT use for generating the brand name itself - use brand-naming instead; for documenting the finished identity system's usage rules, use brand-guidelines; for briefing broader creative direction, use moodboard-builder.
The same file is in 1 other repository
SkillMedev/skills/skills/manuscript-reviser Skill
5★ repoUse when revising fiction prose that ALREADY EXISTS - a second/third-draft pass on a chapter or scene, a continuity or POV-consistency check, fixing a scene that drags, cutting dead weight, or tightening overwritten prose at the line level. Do NOT use to draft a brand-new scene from nothing (use Fiction Scene Writer), to build or mimic an author's voice (use Ghostwriter), or for neutral encyclopedic prose (use Wikipedia Style Writer); to outline or re-architect the plot at the beat level, use Story Structure Architect.
The same file is in 1 other repository
SkillMedev/skills/skills/meeting-agenda Skill
5★ repoBuilds focused, time-boxed meeting agendas where every item has an owner, a timebox, and a named outcome, status updates are pushed to async, and the agenda ships 24 hours before the meeting. Use when someone asks "write an agenda for my planning meeting", "this meeting keeps running over", "how do I make this decision meeting productive", or "our recurring sync feels aimless". Do NOT use for recurring manager-report one-on-ones - use 1on1-agenda instead - or for turning meeting notes into action items - use meeting-notes-to-actions.
SkillMedev/skills/skills/model-card-writer Skill
5★ repoProduces a complete model card - intended use, training data provenance, evaluation results with slices, limitations, and usage guidance - for any model shared beyond its team or affecting people. Use when someone asks "write a model card", "document this model before release", "what should our model documentation include", or is preparing a model for deployment, handoff, or external publication. Do NOT use for producing the underlying evaluation numbers - use model-evaluation-report instead; for ongoing production monitoring plans use data-drift-monitor.
The same file is in 1 other repository
SkillMedev/skills/skills/model-evaluation-report Skill
5★ repoProduces a rigorous, honest evaluation report for an ML model - real baselines, business-matched metrics with confidence intervals, slice-level error analysis, calibration checks, and a go/no-go recommendation. Use when someone asks "is this model good enough to ship", "write up the eval for this model", "did we actually beat the old model", or before any model promotion, stakeholder demo, or retraining decision. Do NOT use for evaluating LLM or prompt outputs - use llm-evaluation instead; for analyzing randomized product experiments use ab-test-analyzer; for documenting a shipped model for consumers use model-card-writer.
The same file is in 1 other repository
SkillMedev/skills/skills/offer-rejection-writer Skill
5★ repoDrafts unambiguous candidate offer letters and respectful, legally-careful candidate rejection notes for a human to review and send. Use when you are asked to write, draft, or word an offer letter, an offer email, or a candidate rejection/decline note - or to soften, tighten, or de-risk an existing draft of one. Do NOT use when writing performance feedback for a current employee - use feedback-writer instead.
The same file is in 1 other repository
SkillMedev/skills/skills/oncall-handoff Skill
5★ repoProduces a complete on-call shift handoff note - shift summary, open incidents, watch items with paging thresholds, silenced alerts, in-flight changes, and escalation contacts - checked against a completeness checklist. Use when someone asks "write my on-call handoff", "what should I tell the next on-call", "my shift ends in an hour, help me hand over", or "make a handoff template for our rotation". Do NOT use for writing the incident postmortem after resolution - use postmortem-writer instead. For live severity assessment during an incident, use sev-triage; for external customer-facing incident comms, use status-page-update.
The same file is in 1 other repository
SkillMedev/skills/skills/one-pager-designer Skill
5★ repoWrites a decision-driving one-pager - problem, evidence, impact, and a specific ask compressed into a single page readable in under three minutes. Use when someone asks "turn this into a one-pager", "write a brief for leadership", "I need a one-page pitch for this decision", or is preparing a document a busy reader must act on from one page. Do NOT use for a client-facing sales proposal with pricing and scope - use sales-proposal-writer instead; for condensing an existing long document use executive-summary; for multi-slide narratives use slide-deck-builder.
The same file is in 1 other repository
SkillMedev/skills/skills/op-ed-writer Skill
5★ repoWrites 600-800 word opinion pieces with a single contestable thesis, a timely news peg, evidence-backed argument paragraphs, an honestly-engaged counterargument, and a memorable closing call to action - flagging factual claims that need verification. Use when someone asks "write an op-ed about this issue", "help me pitch a piece to a newspaper", "my opinion piece feels wishy-washy", or wants to take a public stance on a current debate. Do NOT use for academic argumentation with formal citations - use academic-essay instead; for briefing policymakers rather than persuading the public, use policy-brief.
SkillMedev/skills/skills/performance-review-writer Skill
5★ repoWrites fair, specific, evidence-based performance reviews and ratings. Use when drafting or preparing for calibration to reduce recency bias and vague praise or criticism.
The same file is in 1 other repository
SkillMedev/skills/skills/playwright-testing Skill
5★ repoWrites and reviews end-to-end Playwright tests that survive UI refactors and never fail on timing - resilient locators, web-first assertions, isolated state, and a flake policy with quarantine rules. Use when someone asks "write a Playwright test for this flow", "why is this e2e test flaky", "how do I wait for this element", "what selector should I use", or is setting up a Playwright suite and CI config. Do NOT use for consumer/provider contract tests of API boundaries - use contract-test-writer instead; for turning product requirements into an e2e scenario inventory before any code - use e2e-scenario-author instead; for systematically diagnosing an already-flaky suite - use flaky-test-detangler instead; for designing reusable test fixtures and factories - use test-data-builder instead.
The same file is in 1 other repository
SkillMedev/skills/skills/policy-brief Skill
5★ repoWrites a concise, evidence-based policy brief - problem, options compared on consistent criteria, and a recommendation - that a decision-maker can act on in minutes. Use when someone asks "write a policy brief", "summarize the evidence and options for this decision", "brief the minister/board/council on X", or needs a one-to-four-page document that turns research into a recommended action. Do NOT use for persuasive opinion pieces - use op-ed-writer instead; for long-form marketing documents, use whitepapers; for condensing an existing long document, use executive-summary.
The same file is in 1 other repository
SkillMedev/skills/skills/postmortem-writer Skill
5★ repoWrites blameless incident postmortems with a log-reconstructed timeline, multi-causal contributing factors, and owned, dated action items. Use when someone asks "write the postmortem for yesterday's outage", "run a blameless retro on this incident", "turn these incident notes into a postmortem doc", or after any SEV1 or SEV2 event. Do NOT use for customer-facing incident updates while the incident is live - use status-page-update instead; for transferring context at a shift change, use oncall-handoff; for classifying and running a live incident, use sev-triage.
The same file is in 1 other repository
SkillMedev/skills/skills/power-bi-dax Skill
5★ repoWrites correct, fast DAX measures with proper filter context, time intelligence on a marked date table, and VertiPaq-friendly patterns, diagnosing slow visuals down to the storage-vs-formula engine split. Use when someone asks "why does my DAX measure return the wrong total", "write a YTD or year-over-year measure", "my Power BI report is slow", "CALCULATE isn't doing what I expect", or "measure vs calculated column". Do NOT use for Tableau calculated fields and dashboard design - use tableau-best-practices instead; for writing warehouse SQL and turning query results into findings - use sql-to-insights instead; for Excel or Google Sheets financial models - use spreadsheet-model-builder instead.
The same file is in 1 other repository
SkillMedev/skills/skills/press-release-writer Skill
5★ repoWrites announcement press releases in proper wire format - inverted pyramid structure, a headline under 100 characters carrying the news verb, dateline conventions, quote construction rules (executive quote states vision, customer quote states outcome), and a boilerplate block. Use when a user says "write a press release for our launch", "we're announcing a funding round, draft the release", "turn this announcement into a press release", or "is this press release newsworthy enough". Do NOT use for orchestrating a Product Hunt launch - use product-hunt-launch instead - for running the launch day itself - use launch-day-runbook instead - or for tracking coverage after the release goes out - use media-monitor instead.
The same file is in 1 other repository
SkillMedev/skills/skills/process-doc Skill
5★ repoDocuments recurring processes as step-by-step SOPs with decision points, edge cases, and a named owner, so anyone can run the process correctly without asking. Use when someone asks "write an SOP for this", "document our onboarding process", "this only lives in one person's head", or wants to delegate a recurring task safely. Do NOT use for incident-response or on-call operational runbooks - use runbook-writer instead; for customer-facing product documentation, use help-documentation.
The same file is in 1 other repository
SkillMedev/skills/skills/product-description-writer Skill
5★ repoWrites the single on-site PDP master copy - a benefit-led, scannable product detail page in the brand's voice - from a raw spec sheet or feature list. Use when you have a spec list, feature bullets, or a bare template description for one product and need conversion copy for its on-site product detail page. Do NOT use for Amazon or marketplace listings - use amazon-listing-optimizer instead; do NOT use to spin one master into many size/color variants - use variant-copy-scaler instead.
The same file is in 1 other repository
SkillMedev/skills/skills/prototype-spec Skill
5★ repoTurns a static design into a numbered, testable, dev-ready specification covering every state, interaction, breakpoint, motion detail, and edge case the mockup cannot show. Use when someone asks "write the spec for this screen", "engineering keeps asking what happens when", "document the interactions before handoff", "what states does this component need", or a build came back wrong because behavior was never written down. Do NOT use for the motion token details themselves - use motion-spec instead; for verifying a finished build against the spec, use design-qa-checklist.
The same file is in 2 other repositories
SkillMedev/skills/skills/resume-writer Skill
5★ repoBuilds an ATS-optimized resume from scratch or raw career notes, then exports a clean .docx. Use when someone needs to write or rebuild a resume.
The same file is in 1 other repository
SkillMedev/skills/skills/review-to-faq-builder Skill
5★ repoMines customer reviews and Q&A exports into a pre-purchase PDP FAQ and objection-handling block that answers shopper hesitation before it forms, ordered by conversion impact. Use when someone asks "turn these reviews into an FAQ", "shoppers keep asking the same questions before buying", "how do I address the negative reviews on the product page", or has a review or Q&A export and wants to write or rebuild a product page FAQ or cut returns from preventable surprises. Do NOT use to analyze support tickets or CSAT/NPS verbatims for quality root causes - use csat-root-cause instead; do NOT use to write the main product description - use product-description-writer instead.
The same file is in 1 other repository
SkillMedev/skills/skills/rfp-response-writer Skill
5★ repoAnswers RFPs and security questionnaires with discipline - a go/no-go score before any writing (win probability times deal size against effort, under 30 percent win chance means decline), a compliance matrix mapping every requirement to a response, answer-library reuse, and win themes threaded through every section. Use when a user says "we got an RFP, help us respond", "should we even bid on this RFP", "build a compliance matrix for this RFP", "answer this security questionnaire", or "our RFP responses take weeks and we keep losing". Do NOT use for proactive proposals sent without a formal solicitation - use sales-proposal-writer instead.
The same file is in 1 other repository
SkillMedev/skills/skills/rubric-builder Skill
5★ repoBuilds grading rubrics - analytic, holistic, or single-point - with criteria traced to learning objectives, 3-5 performance levels, observable behavior in every cell, and defensible weighting. Use when someone asks "make a rubric for this essay", "how should I grade this project", "turn these objectives into scoring criteria", or "my rubric feels vague, fix it". Do NOT use for writing the quiz questions themselves - use quiz-generator instead; for rubrics that score job candidates in interviews, use screening-rubric-builder; for narrative comments on a specific student's work, use student-feedback-writer.
The same file is in 1 other repository
SkillMedev/skills/skills/runbook-writer Skill
5★ repoWrites an operational runbook for a service covering symptoms, diagnostic checks, mitigations, and escalation paths. Use when shipping a new service or when an existing service lacks incident procedures.
The same file is in 1 other repository
SkillMedev/skills/skills/salary-negotiation Skill
5★ repoPrepares and scripts salary and job-offer negotiations - market research, target/minimum/anchor numbers, BATNA strength, deflection and counter scripts, and total-compensation trades when base is capped. Use when someone asks "how do I negotiate my offer", "they asked my salary expectations, what do I say", "is this offer low", or "how do I counter without losing the offer". Do NOT use for writing resumes, cover letters, or managing the application pipeline - use job-application instead; for declining an offer gracefully, see offer-rejection-writer.
The same file is in 1 other repository
SkillMedev/skills/skills/sales-proposal-writer Skill
5★ repoWrites a B2B sales proposal or SOW that restates the buyer's problem in their own words, quantifies the cost of inaction, presents price as anchored options, and drives one dated next step. Use when someone asks "write a proposal for this client", "turn my discovery notes into a proposal", "how should I present pricing in this proposal", or when a deal needs a document to move from discovery to close. Do NOT use for a one-page internal decision brief - use one-pager-designer instead; for investor decks use pitch-deck-builder; for setting the underlying price model use pricing-strategy.
The same file is in 3 other repositories
SkillMedev/skills/skills/scope-creep-defense Skill
5★ repoDetects scope creep and converts it to paid work using the new-request test, a one-yes courtesy budget, a word-for-word change-order script, and a relationship-preserving no. Use when a freelancer says "the client keeps asking for little extras", "this project has doubled and the price hasn't", "how do I say no without losing the client", "they want one more quick thing", "can I charge for this add-on", or "the retainer hours are gone but requests keep coming". Do NOT use for writing the contract clauses that make this enforceable - use statement-of-work-writer instead; this skill enforces at delivery time what that skill establishes at signing.
The same file is in 1 other repository
SkillMedev/skills/skills/sermon-writer Skill
5★ repoStructures sermons, lessons, and motivational talks around one central idea with the classic teaching shape - a hook, three parallel points each stated, explained, illustrated, and applied, a concrete application, and a bookend close - plus timing and emphasis notes. Use when someone asks "outline my sermon on this passage", "structure a talk with three points", "help me land the close of my message", or has a theme and needs it built into a deliverable outline. Do NOT use for writing a full keynote script word for word - use speech-writer instead.
SkillMedev/skills/skills/show-notes-writer Skill
5★ repoProduces complete podcast show notes from a transcript or episode outline - a standalone summary block, timestamped chapters that name what happens, screenshot-worthy key takeaways, guest bio, curated links, and keyword placement for search. Use when someone says "write show notes for this episode", "turn this transcript into an episode description", "add chapters and timestamps", or "make this episode findable on Google". Do NOT use to fan the episode out into clips, quote cards, and social posts - use content-repurposing instead; do NOT use to write burned-in video captions from the transcript - use captions-from-transcript instead; do NOT use to pitch the show to other podcasts - use podcast-pitch instead.
The same file is in 1 other repository
SkillMedev/skills/skills/skill-auditor Skill
5★ repoUse when reviewing, grading, auditing, or improving a whole existing skill or pack - judging whether a skill is good, fixing one that misfires or won't activate, or driving one or many skills to a quality bar. Audits to an absolute A+ bar and hands back ship-ready SKILL.md rewrites, not a report the user must act on. Do NOT use when tightening only a description or trigger in isolation - use skill-description-writer instead; do NOT use when authoring a brand-new skill from scratch - use skill-creator instead.
The same file is in 1 other repository
SkillMedev/skills/skills/skill-author Skill
5★ repoThe section-by-section anatomy standard every paid-quality SKILL.md must meet. Use when drafting or restructuring the BODY of a skill, deciding what sections it needs, or checking a draft against the house standard - "what sections does a skill need", "structure this SKILL.md", "is this skill body complete". Do NOT use for the end-to-end creation process from a raw idea (use skill-creator), grading a finished skill (use skill-auditor), or writing only the description field (use skill-description-writer).
SkillMedev/skills/skills/skill-creator Skill
5★ repoUse when authoring a brand-new skill from scratch - turning a capability idea or a "make me a skill that…" request into a complete SKILL.md with a trigger-precise description and the full paid-quality anatomy: procedure, elicitation, thresholds, worked artifact, deliverable, Do NOT, quality bar. Triggers on "write a new SKILL.md from scratch", "turn this capability idea into a complete skill". Do NOT use to review or grade an existing skill (use skill-auditor), to convert an existing prompt (use prompt-to-skill), or for writing unrelated to skills.
The same file is in 1 other repository
SkillMedev/skills/skills/skill-description-writer Skill
5★ repoWrites the description field that makes a skill fire reliably - WHAT it does, WHEN to invoke it with quoted user phrasing, and what it is NOT for. Use when drafting or improving only the description or trigger of a SKILL.md or catalog entry - "this skill never fires", "fix this description", "write the frontmatter description". Do NOT use to author a whole skill (use skill-creator) or to grade/audit one (use skill-auditor).
The same file is in 1 other repository
SkillMedev/skills/skills/social-caption-writer Skill
5★ repoWrite one platform-native caption from a topic and brand voice, with a front-loaded hook, native length, and a single earned CTA. Use when the user gives a topic (and optionally brand voice or a described image/video) and asks for an Instagram, LinkedIn, X/Twitter, or TikTok caption. Do NOT use when the user wants a dedicated standalone LinkedIn post - use linkedin-post-writer instead; or a multi-post X thread - use tweet-thread-builder instead; or to adapt one existing piece of content into versions for several channels - use cross-platform-reformatter instead.
The same file is in 1 other repository
SkillMedev/skills/skills/speech-writer Skill
5★ repoWrites full speeches for the ear - a narrative arc from hook to callback close, three story-anchored movements, two or three quotable lines built with antithesis and imagery, and pause and timing markers budgeted at roughly 130 words per minute. Use when someone asks "write my keynote", "draft a wedding toast", "I have 10 minutes on stage, write the speech", or has a talk drafted that reads fine but dies when spoken aloud. Do NOT use for a sermon or teaching outline with application points - use sermon-writer instead; for rehearsing an investor pitch, use pitch-practice-coach.
SkillMedev/skills/skills/stakeholder-update Skill
5★ repoWrites project stakeholder updates readable in under 60 seconds - honest RAG status, decisions made, explicit asks with owners and dates, next milestones - tiered to the audience. Use when someone asks "write my weekly project update", "how do I tell stakeholders we're at risk", "draft a status email for leadership", or "my updates get ignored, fix the format". Do NOT use for aggregating many teams' statuses into one engineering-wide report - use eng-status-rollup instead. For monthly investor letters with metrics and asks to VCs, use investor-update-writer; for customer-facing incident status, use status-page-update.
The same file is in 1 other repository
SkillMedev/skills/skills/statement-of-work-writer Skill
5★ repoWrites a dispute-preventing statement of work with explicit inclusions and exclusions, a 2-revision-round limit, acceptance criteria, a 50-percent-upfront or milestone payment schedule, and a change-order clause, from a full template with [FILL] fields. Use when a freelancer or consultant says "write my SOW", "the client keeps adding stuff and I have nothing in writing", "how do I define scope in the contract", "what should my payment terms be", "draft a statement of work for this project", or "client won't sign off on the deliverable". Do NOT use for the persuasive proposal that wins the work - use sales-proposal-writer instead; this skill contracts work already agreed in principle.
The same file is in 2 other repositories
SkillMedev/skills/skills/status-page-update Skill
5★ repoWrites customer-facing incident status updates for each lifecycle stage - investigating, identified, monitoring, resolved - with cadence rules and plain-language templates. Use when someone asks "write a status page update", "what do we tell customers about this outage", "draft the resolved notice", or during an active incident needing customer communication. Do NOT use for the internal post-incident analysis - use postmortem-writer once the incident is closed; for deciding severity and internal escalation flow use sev-triage; for summarizing an incident upward to executives use escalation-summary.
The same file is in 1 other repository
SkillMedev/skills/skills/story-structure-architect Skill
5★ repoUse when plotting or outlining a novel or screenplay, structuring its acts/chapters/sequences, fixing a sagging middle or broken pacing, mapping a character arc onto plot beats, planting setups and their payoffs, or deciding scene order. Produces the macro architecture - arc, beat sheet, tension curve - not prose. Do NOT use to write the actual prose of a scene (use Fiction Scene Writer, which sits downstream of this), to establish or mimic a narrative VOICE (use Ghostwriter), or to write a non-fiction book proposal or pitch (use Book Proposal).
The same file is in 1 other repository
SkillMedev/skills/skills/student-feedback-writer Skill
5★ repoWrites specific, growth-oriented feedback on student work using the Glow-Grow-Go structure - evidence from the actual work, one improvement priority, and a concrete next action - sized to the context from draft comments to progress reports. Use when someone asks "write feedback on this essay", "help me comment on these lab reports", "draft progress report narratives", or "make this comment more useful to the student". Do NOT use for feedback to colleagues or direct reports at work - use feedback-writer instead; for formal employee performance reviews, use performance-review-writer; for building the scoring rubric itself, use rubric-builder.
The same file is in 1 other repository
SkillMedev/skills/skills/tdd-expert Skill
5★ repoDrive development with strict Red-Green-Refactor discipline - write one failing test, write the minimum code to pass it, refactor on green - including test-list planning and a worked kata cycle. Use when someone asks "write this test-first", "do TDD on this feature", "help me practice red-green-refactor", "write a failing test for this bug", or wants tests to drive a new module's design. Do NOT use for adding tests to existing untested legacy code before a refactor - use characterization-test-writer instead - or for designing shared fixtures and factories - use test-data-builder instead.
The same file is in 3 other repositories
SkillMedev/skills/skills/technical-spec Skill
5★ repoWrites engineering design docs and RFCs that align a team before code - TL;DR, background, goals and explicit non-goals, quantified requirements, a concrete end-to-end design with failure modes, alternatives considered, rollout plan, and open questions surfaced at the top for reviewers. Use when an engineer asks "write a design doc for this feature", "turn my approach into an RFC", "reviewers keep asking why didn't you just X", or a project needs alignment before implementation. Do NOT use for designing the API contract itself - use api-design instead; for user-facing product documentation, use help-documentation.
The same file is in 1 other repository
SkillMedev/skills/skills/thumbnail-concept Skill
5★ repoProduces three distinct high-CTR YouTube thumbnail concepts per video - each a full spec with focal point, precise facial-expression direction, text overlay copy, color and background direction, and two paired title variants. Use when someone says "I need a thumbnail idea", "why is my CTR low", "help me pick a thumbnail and title", or is planning a video before filming and wants the click package designed first. Do NOT use for the spoken and visual opening seconds of the video itself - use video-hook-writer instead; do NOT use to write the full video - use youtube-script-writer instead; do NOT use for cropping, captioning, or exporting finished video files - use social-video-formatter instead.
The same file is in 1 other repository
SkillMedev/skills/skills/tweet-thread-builder Skill
5★ repoTurn one idea into a tight tweet thread - a hook that earns the click, one beat per post, and momentum to a single CTA. Use when someone asks "turn this into a thread", "write a thread about my launch", "why did my thread flop", or "give me hook options for this". Do NOT use for LinkedIn-format posts - use linkedin-post-writer instead. Do NOT use for adapting one finished piece across many platforms - use content-repurposing instead.
The same file is in 2 other repositories
SkillMedev/skills/skills/typescript-strict Skill
5★ repoWrite and review TypeScript as if strict mode plus the hardening flags (noUncheckedIndexedAccess, exactOptionalPropertyTypes) are enforced, and migrate loose codebases to full strictness flag by flag without breaking the build. Use when someone asks "how do I get rid of any", "turn on strict mode in an existing project", "is this type assertion safe", "why does tsc say possibly undefined", or when writing new TypeScript that must pass a strict compiler. Do NOT use for migrating between language or runtime versions - use language-version-migrator instead.
The same file is in 1 other repository
SkillMedev/skills/skills/ux-writing-audit Skill
5★ repoAudits an existing corpus of product copy - buttons, labels, errors, empty states, toasts, tooltips - against clarity, consistency, voice, and actionability heuristics, and delivers a scored findings table with rewrites plus a reusable glossary. Use when someone asks "audit our product copy", "why does our UI text feel inconsistent", "review these error messages", "is it log in or sign in", or before a redesign or localization push. Do NOT use for writing new error messages from scratch - use error-message-writer instead; for first-run and activation flows, use onboarding-copy.
SkillMedev/skills/skills/variant-copy-scaler Skill
5★ repoGenerates distinct, on-brand copy for every size, color, and bundle variant from a single master description, splitting a shared core from a thin per-variant layer so variant pages avoid thin or duplicate-content problems. Use when someone asks "write descriptions for all 12 colorways", "our variant pages are cannibalizing each other", "should each SKU get its own page", or when one product ships in many variants and needs per-variant PDP copy, or near-identical variant pages are creating duplicate-content or canonical problems. Do NOT use to write the single master or parent PDP description from specs - use product-description-writer instead; do NOT use for category or collection page copy - use category-page-copywriter instead.
The same file is in 1 other repository
SkillMedev/skills/skills/vc-pitch-email Skill
5★ repoWrites cold investor outreach under 100 words - a subject line built on the company's strongest verifiable metric, a personalized why-them opening line, traction before the ask, and a low-friction meeting request - delivered as three subject options, the email body with word count, and a follow-up line for five days later. Use when a founder asks "write a cold email to this VC", "how do I get an investor meeting", "pitch my seed round over email", or is starting investor outreach. Do NOT use for choosing which investors to contact - use investor-targeting instead - or for post-investment monthly updates - use investor-update-writer instead - or for non-investor sales outreach - use cold-email-craft instead.
The same file is in 2 other repositories
SkillMedev/skills/skills/video-hook-writer Skill
5★ repoWrites the spoken line plus visual frame combination for the first 3 seconds of a short-form video, delivering labeled variants built from six proven hook formulas and matched to TikTok, Reels, or Shorts. Use when someone says "write a hook for this video", "my Shorts die in the first seconds", "give me openers for this TikTok", or "how should this Reel start". Do NOT use for the first line of a written post, thread, or caption - use social-hook-generator instead; do NOT use to build the full thread after the opener - use tweet-thread-builder instead; do NOT use for the 30-second intro of a long-form YouTube video - use youtube-script-writer instead; do NOT use to design the clickable image for a video - use thumbnail-concept instead.
The same file is in 1 other repository