Docs & writing
16,621 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
jacob-balslev/skill-graph/marketplace/skills/skill-scaffold Skill
no license1★ repoUse when creating a new SKILL.md from scratch, restructuring a draft before it becomes a stable skill, or teaching another author the canonical Skill Metadata Protocol frontmatter, body, and audit-state.json sidecar structure. Covers flat schema-conformant frontmatter, the sidecar split, v8 classification, body layout by skill intent, semantic-layer discipline (description vs activation vs Coverage), teaching-layer mechanics (TEMPLATE NOTE blockquotes), native skill-creator handoff, public/private safety, and routing-eval honesty. Do NOT use when modifying an already-written skill (edit it directly), writing general technical documentation, routing an existing request across skills, or fixing malformed library health at scale (use `skill-infrastructure`). Do NOT use for refactor my existing skill to be more concise. Do NOT use for my skill's routing isn't activating — why? Do NOT use for audit my skill library for stale frontmatter. Do NOT use for write a developer guide for the contributor docs.
jacob-balslev/skill-graph/marketplace/skills/summarization Skill
no license1★ repoUse when condensing prose while preserving meaning: session findings, wrap reports, research briefs, executive summaries, TLDRs, agent handoffs, progressive summaries, audit summaries, and long-document distillation. Covers extractive vs abstractive summarization, what to keep vs drop, evidence preservation, summary levels, handoff summaries, and audit-report condensation without hiding findings. Do NOT use for byte/data compression algorithms (use `compression`), context-window budget math or compaction triggers (use `context-window`), working-set selection (use `context-management`), prose tone repair (use `writing-humanizer`), or quality scoring (use `evaluation`).
jacob-balslev/skill-graph/marketplace/skills/testing-strategy Skill
no license1★ repoUse when planning tests for a bug fix, feature, or refactor — deciding what deserves a test, at which level, with what evidence. Covers test-scope decisions, test-level selection (unit / integration / contract / e2e), effort-to-risk matching, regression targeting, evidence quality, and failure-case coverage. Do NOT use for chasing a known failure (that is `debugging`), for pure doc writing (that is `documentation`), or for conceptual architecture discussion with no verification target (no dedicated skill — treat as strategy, not testing). Do NOT use for my existing test is failing — why? Do NOT use for write a testing-patterns guide for the contributor docs. Do NOT use for clean up this duplicated test setup across three files.
jacob-balslev/skill-graph/marketplace/skills/typography-system Skill
no license1★ repoUse when designing a typography system — typeface selection and pairing, modular type scale, vertical rhythm, line-height and measure rules, and web font delivery (subsetting, font-display, variable fonts). Do NOT use for body copy writing, single-headline font pairing, or non-text design tokens. Do NOT use for Write the headline copy for the landing page. Do NOT use for Pick the brand's primary color. Do NOT use for Decide where the headline component lives in the folder structure.
jacob-balslev/skill-graph/marketplace/skills/visual-hierarchy Skill
no license1★ repoUse when establishing visual hierarchy — type scale ratios, spacing rhythm, contrast as ordering signal, weight and size as importance, and the layered relationship between primary, secondary, and tertiary information. Do NOT use for content writing, information architecture, or specific color palette construction. Do NOT use for Write the H1 copy that should appear at the top of the landing page. Do NOT use for Choose between sans-serif and serif typefaces for the brand. Do NOT use for Pick the brand's primary color.
jacob-balslev/skill-graph/marketplace/skills/writing-humanizer Skill
no license1★ repoUse when writing or editing human-readable prose such as docs, PRs, issues, release notes, errors, UI copy, commits, tooltips, or support replies, especially when text sounds robotic, padded, monotonous, or overly formal. Covers AI-tell removal, active voice, hedging reduction, readability diagnosis, sentence rhythm, vocabulary variety, tone mapping, paragraph rhythm, bullets-vs-prose choice, and the 5-step humanization workflow. Do NOT use for documentation routing/type selection, code-identifier naming, or in-product UI-text pattern catalogs. Do NOT use for decide kebab-case vs camelCase for this new database column. Do NOT use for draft the marketing headline for the pricing page with strong persuasion. Do NOT use for restructure this doc into a tutorial format with progressive disclosure. Do NOT use for rewrite this UI button label so it names the actual action instead of saying Submit. Do NOT use for rename this React component across all call-sites in the repo. Do NOT use for audit this WCAG 2.
itsyasirkhandev/spec-driven-development/skills/development/grill-with-docs Skill
no license1★ repoGrilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.
The same file is in 11 other repositories
itsyasirkhandev/spec-driven-development/skills/matt pocock/grill-with-docs Skill
no license1★ repoGrilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.
The same file is in 11 other repositories
itsyasirkhandev/spec-driven-development/skills/matt pocock/setup-matt-pocock-skills Skill
no license1★ repoSets up an `## Agent skills` block in AGENTS.md/CLAUDE.md and `docs/agents/` so the engineering skills know this repo's issue tracker (GitHub or local markdown), triage label vocabulary, and domain doc layout. Run before first use of `to-issues`, `to-prd`, `triage`, `diagnose`, `tdd`, `improve-codebase-architecture`, or `zoom-out` — or if those skills appear to be missing context about the issue tracker, triage labels, or domain docs.
The same file is in 15 other repositories
itsyasirkhandev/spec-driven-development/skills/write-a-skill Skill
no license1★ repoCreate new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.
The same file is in 1 other repository
almasumdev/awesome-java-android-agent-skills/.github/skills/ui/java-localization Skill
no license1★ repoExpert guidance on localizing Android apps from Java — strings.xml variants, plurals, ICU MessageFormat, RTL, and per-app locale. Use this when adding a language, handling pluralization, or enabling runtime language switching.
diamitani/rostr-agent/optional-skills/mlops/whisper Skill
1★ repoOpenAI's general-purpose speech recognition model. Supports 99 languages, transcription, translation to English, and language identification. Six model sizes from tiny (39M params) to large (1550M params). Use for speech-to-text, podcast transcription, or multilingual audio processing. Best for robust, multilingual ASR.
The same file is in 1 other repository
diamitani/rostr-agent/optional-skills/security/web-pentest Skill
1★ repoAuthorized web application penetration testing — reconnaissance, vulnerability analysis, proof-based exploitation, and professional reporting. Adapts Shannon's "No Exploit, No Report" methodology with hard guardrails for scope, authorization, and aux-client leakage. Active testing against running applications you own or have written authorization to test.
diamitani/rostr-agent/skills/research/research-paper-writing Skill
1★ repoWrite ML papers for NeurIPS/ICML/ICLR: design→submit.
The same file is in 1 other repository
diamitani/rostr-agent/skills/software-development/plan Skill
1★ repoPlan mode: write an actionable markdown plan to .hermes/plans/, no execution. Bite-sized tasks, exact paths, complete code.
The same file is in 1 other repository
coreline-ai/codex-skill-factory/Test/skill-case-100-prompts/generated-skills/generate-release-notes Skill
1★ repoUse when the user repeatedly asks to generate release notes from commits, diffs, PRs, or git changes (10 similar examples).
coreline-ai/codex-skill-factory/Test/skill-case-100-prompts/generated-skills/update-docs Skill
1★ repoUse when the user asks to update README, docs, API documentation, usage guides, or changelog-like documentation.
Ryan-focus/skill-trust/tests/fixtures/with-endpoints Skill
1★ repoA skill that uploads reports to an API.
yli769227-jpg/agent-discipline/skills/check-versions Skill
1★ repoCheck the forge temperature before you cast. When touching a language feature, runtime behavior, or framework/SDK API, verify the actual installed version first, then read that version's docs, then write code. Triggers before using any concrete API (Node/Python/Go/Rust/any SDK), when you'd be trusting how-you-remember-it, or on version-sensitive errors. Never code from training-data version assumptions. 先测炉温再铸剑:用任何 API 前先查实际版本→查该版本文档→再写代码。禁止凭训练数据的版本假设直接写代码。
yli769227-jpg/agent-discipline/skills/log-first Skill
1★ repoLog first (observability). New code must include key-path logging: connection established, state change, error, request/response. Triggers when you're about to write a new module, interface, async task, or external call — or when debugging code that has no logs. Writing buggy code is normal; locating the bug is the hard part. 日志优先:新代码必须含关键路径日志(连接、状态变化、错误、请求/响应)。触发:写新模块/接口/异步任务/外部调用,或 debug 无日志代码时。写代码犯错正常,定位问题才难。 不触发:纯改文案/配置、纯重命名、写测试断言,或模块已有完整关键路径日志。
kwhorne/elyra-skills/skills/changelog Skill
1★ repoMaintain a CHANGELOG.md following the Keep a Changelog format with semver. Use when the user asks to update the changelog, add release notes, prepare a release, or generate changelog entries from commits or merged PRs.
kwhorne/elyra-skills/skills/i18n-review Skill
1★ repoAudit code and UI for internationalization correctness - string extraction, pluralization, dates/numbers/currencies, RTL support, and locale-aware sorting. Use when the user asks for an i18n review, localization audit, or wants to make an app translation-ready.
kwhorne/elyra-skills/skills/onboarding-doc Skill
1★ repoWrite or audit onboarding documentation so a new engineer can get productive without ambient knowledge - setup, architecture, conventions, who to ask. Use when the user asks to write onboarding docs, improve dev setup instructions, create a getting-started guide, or audit new-hire experience.
kwhorne/elyra-skills/skills/runbook-author Skill
1★ repoWrite a runbook for on-call so the next person can resolve an alert without paging the author - symptoms, diagnostics, mitigation, escalation. Use when the user asks to write a runbook, document an alert, create an incident playbook, or improve on-call ergonomics.
kwhorne/elyra-skills/skills/spec-writing Skill
1★ repoWrite a focused spec before building - problem statement, scope, acceptance criteria, edge cases, and open questions. Use when the user describes a feature to build, asks for a spec or PRD, or starts a task that is too vague to implement directly.
kwhorne/elyra-skills/skills/test-writing Skill
1★ repoDecide what to test, structure tests with arrange/act/assert, and avoid common pitfalls. Use when the user asks to write, add, or improve tests for existing code, or wants test coverage for a new feature.
almasumdev/awesome-react-native-agent-skills/.github/skills/ui/rn-localization Skill
no license1★ repoExpert guidance on i18n in React Native with i18next or Lingui, ICU plurals, dynamic locale switching, and RTL layout mirroring. Use when asked about translations, plurals, locale, or RTL.
Auto skill build supercharge feedback loop
Arnie016/codex-prompt-templates/skills/auto-skill-build-supercharge-feedback-loop Skill
1★ repoRun closed-loop evaluators for Codex Supercharge artifacts and write feedback state for future Codex sessions, subagents, and automations. Use after creating, editing, reviewing, grading, or validating Codex Supercharge skills, references, scripts, metadata, or public docs. Triggers: grade Supercharge edits, closed-loop feedback, evaluator handoff, subagent status, automation feedback. Skip when the task is a one-off repo edit outside Codex Supercharge.
Auto skill safety mcp secret guard
Arnie016/codex-prompt-templates/skills/auto-skill-safety-mcp-secret-guard Skill
1★ repoPrevent secret leakage when adding or reviewing MCP server configs. Use when you see `mcpServers` JSON, `.env`, config snippets, tool docs, or logs that might contain API keys/tokens. Produces a redacted config + a short secret hygiene report.
Arnie016/codex-prompt-templates/skills/openapi-to-mcp-skill Skill
1★ repoConvert OpenAPI/Swagger APIs into Codex-friendly MCP/tool workflows and generated skills. Use when the user wants to expose an API to agents, create a skill from API docs, use toolcast-style conversion, or design safe API tool schemas. Triggers: OpenAPI to MCP, Swagger to tools, API tool plan, generate MCP server from API spec. Skip when there is no stable spec or the user only needs one ad-hoc HTTP request.
Arnie016/codex-prompt-templates/skills/repo-to-wiki Skill
1★ repoBuild a local markdown wiki for a repo, research folder, or cloned source collection. Use when the user wants living docs, repo explainers, source synthesis, citations, cross-links, or llmwiki-style knowledge accumulation.
designgrappler/agent-os/skills/report-track-status Skill
1★ repoThe "Situation Report" that produces a quick, scannable summary of all active tracks — what's in progress, blocked, awaiting review, or needs approval. Ideal after a break or at session start.
eliransu/digital-brain/skills/obsidian-markdown Skill
1★ repoWrite correct Obsidian Flavored Markdown: wikilinks, embeds, callouts, properties, tags, highlights, math, and canvas syntax. Reference this when creating or editing any wiki page. Triggers on: write obsidian note, obsidian syntax, wikilink, callout, embed, obsidian markdown, wikilink format, callout syntax, embed syntax, obsidian formatting, how to write obsidian markdown.
The same file is in 9 other repositories
eliransu/digital-brain/skills/write Skill
1★ repoDraft text in your voice. Applies the rules from VOICE.md (do/don't list) to anything you will send or publish - Slack messages, DMs, internal emails, external emails, Reddit/LinkedIn posts, replies to inbound messages, or rewrites of existing drafts. Triggers on: "/write", "draft this for me", "rewrite in my voice", "reply to this", "send a slack to X", "email Y about Z", "post about X".
sonsriver4815/agent-skill-starter/examples/release-notes Skill
1★ repoUse this skill when the user asks to draft release notes, summarize shipped changes, prepare a changelog entry, or turn commits into reader-facing update notes.
sonsriver4815/agent-skill-starter/src/agent_skill_starter/examples/release-notes Skill
1★ repoUse this skill when the user asks to draft release notes, summarize shipped changes, prepare a changelog entry, or turn commits into reader-facing update notes.
MarcoAntolini/cursor-sync/agents/skills/docs/readme-wizard Skill
no license1★ repoGenerate a polished, professional README.md for any project — from scratch or by improving an existing one. Use this skill whenever the user mentions README, wants to improve their repo's first impression, asks about shields.io badges, wants a star history chart, contributor avatars, documentation tables, project structure trees, or mermaid architecture diagrams in their README. Also use it when someone wants their GitHub repo to "look more professional", "look legit", or make a better first impression — even if they never say the word "README". Covers badge generation, README rewrites for new versions, fork customization, and adapting README structure to different project types (libraries, apps, docs repos, monorepos). Does NOT cover: CONTRIBUTING.md, CHANGELOG, API documentation, CI/CD setup, GitHub profile READMEs, or generating docs for individual components.
MarcoAntolini/cursor-sync/agents/skills/mattpocock/engineering/grill-with-docs Skill
no license1★ repoA relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
The same file is in 19 other repositories
MarcoAntolini/cursor-sync/agents/skills/mattpocock/productivity/research Skill
no license1★ repoInvestigate a question against high-trust primary sources and capture the findings as a Markdown file in the repo. Use when the user wants a topic researched, docs or API facts gathered, or reading legwork delegated to a background agent.
The same file is in 11 other repositories
MarcoAntolini/cursor-sync/agents/skills/mattpocock/productivity/writing-great-skills Skill
no license1★ repoReference for writing and editing skills well — the vocabulary and principles that make a skill predictable.
The same file is in 11 other repositories
MarcoAntolini/cursor-sync/agents/skills/testing/playwright-best-practices Skill
no license1★ repoUse when writing Playwright tests, fixing flaky tests, debugging failures, implementing Page Object Model, configuring CI/CD, optimizing performance, mocking APIs, handling authentication or OAuth, testing accessibility (axe-core), file uploads/downloads, date/time mocking, WebSockets, geolocation, permissions, multi-tab/popup flows, mobile/responsive layouts, touch gestures, GraphQL, error handling, offline mode, multi-user collaboration, third-party services (payments, email verification), console error monitoring, global setup/teardown, test annotations (skip, fixme, slow), test tags (@smoke, @fast, @critical, filtering with --grep), project dependencies, security testing (XSS, CSRF, auth), performance budgets (Web Vitals, Lighthouse), iframes, component testing, canvas/WebGL, service workers/PWA, test coverage, i18n/localization, Electron apps, or browser extension testing. Covers E2E, component, API, visual, accessibility, security, Electron, and extension testing.
The same file is in 1 other repository
MarcoAntolini/cursor-sync/cursor-skills/update-changelog Skill
no license1★ repoMaintains CHANGELOG.md per Keep a Changelog 1.1.0. Two workflows: refresh [Unreleased] from git (update-changelog command), or cut a semver release and bump version manifests (update-changelog-release command). Use when the user invokes those commands, asks to update the changelog, refresh Unreleased, or release a new version with aligned package versions.
paulnsorensen/skillz-that-grillz/skills/oss-hygiene Skill
1★ repoBring an open-source GitHub repository up to community-standards and supply-chain hygiene baseline: scaffold the GitHub Community Standards files (README check, LICENSE, CODE_OF_CONDUCT, CONTRIBUTING, SECURITY, issue + PR templates), wire Dependabot version updates, the Dependency Review action, OpenSSF Scorecard, and CodeQL (when applicable), check Dependabot alerts and secret scanning, and add the OpenSSF Best Practices Badge link. Use when the user says "set up OSS hygiene", "make this repo open-source-ready", "add community health files", "wire dependabot", "add scorecard", "OSSF badge", "supply chain hardening", or invokes /oss-hygiene on a public repo. Idempotent — safe to re-run; diffs against templates and asks before overwriting. Distinct from /gh-bootstrap (merge-button + branch protection) and /safe-settings (org-scale settings as code): focuses on the contributor-facing and supply-chain surface, not merge or org policy. Run after /gh-bootstrap; before announcing the repo.
paulnsorensen/skillz-that-grillz/skills/release Skill
1★ repoEnd-to-end release cutting for a GitHub repo: decide the next semantic version from the Conventional Commits since the last tag, draft proper release notes (GitHub auto-generated via `.github/release.yml`, or hand-curated grouped by change type with highlights and upgrade notes for breaking changes), create and push an annotated tag, publish the GitHub release, and optionally update `CHANGELOG.md`. Use when the user says "cut a release", "tag a release", "publish a release", "ship vX.Y.Z", "bump the version", "what version should this be", "write the release notes", "draft the changelog", or invokes /release. Distinct from /gh-bootstrap (which scaffolds the `.github/release.yml` + release workflow plumbing once) and /gh (raw per-command `gh release` ops): this skill runs the actual release ceremony — version decision, notes, tag, publish. Run after the work is merged to the default branch.
jjfroehlich/agent-skills-for-academic-research/skills/grant-writing Skill
1★ repoUse when the user is planning, drafting, revising, or reviewing a grant or fellowship application, including specific aims, project summaries, significance/innovation/approach sections, funder-fit checks, budget-feasibility alignment, risk/alternative plans, resubmissions, interviews, or reviewer-facing funding narratives. Trigger only when the artifact or decision is part of a funding mechanism; for manuscript peer review, journal submission, general prose editing, or career materials without a funding context, use a different skill.
jjfroehlich/agent-skills-for-academic-research/skills/scientific-communication Skill
1★ repoUse when the user needs to design, review, adapt, or rehearse scientific communication for a live, spoken, visual, or audience-facing setting: talks, slide decks, posters as presentation artifacts, chalk talks, elevator pitches, public explanations, research stories, delivery plans, timing, or Q&A preparation. Trigger from drafts, outlines, venue/audience constraints, slide or poster plans, scripts, or rehearsal concerns. Prefer writing for manuscript prose, visualization for chart/figure design decisions, and publishing for submission or peer-review logistics.
jjfroehlich/agent-skills-for-academic-research/skills/scientific-writing Skill
1★ repoAgent skills for academia research: writing, dataviz, publishing, communication, career, and more.
almasumdev/awesome-kotlin-multiplatform-agent-skills/.github/skills/ui/kmp-localization Skill
no license1★ repoInternationalization with `compose-resources` — string qualifiers, ICU plurals, RTL layout, per-locale fallbacks, and runtime locale switching. Use when shipping to multiple markets.
justincordova/agents/skills/sync-docs Skill
1★ repoUse on-demand to reconcile documentation with the current state of the codebase. Handles two cases — catching drift from past work and consolidating doc updates after iterating on a feature multiple times. Never runs automatically.
justincordova/agents/skills/writing-skills Skill
1★ repoUse when creating new skills, editing existing skills, or improving skill quality
ChristopherAlphonse/calphonse-skills/documentation-writer Skill
1★ repoDiátaxis Documentation Expert with brand voice guidance. An expert technical writer specializing in creating high-quality software documentation, guided by the Diátaxis framework and product copy principles.
ChristopherAlphonse/calphonse-skills/systems-architecture Skill
1★ repoGenerates a high-level system architecture document by analyzing lifecycle documentation and identifying major actors, their interactions, and technologies used.
taleshagn-horushub/thoth/skills/github-gem-seeker Skill
1★ repoSearch GitHub for battle-tested solutions instead of reinventing the wheel. Use when the user's problem is universal enough that open source developers have probably solved it already—especially for: format conversion (video/audio/image/document), media downloading, file manipulation, web scraping/archiving, automation scripts, and CLI tools. Prefer this skill over writing custom code for well-trodden problems.
philpalmieri/engineering-manager-skills/skills/management/direct-report-prep Skill
1★ repoPrepare coaching-oriented 1:1 talking points for a direct report. Gathers GitHub activity, vault context, and open follow-ups to build structured prep notes. Use when prepping for a 1:1 with someone you manage.
philpalmieri/engineering-manager-skills/skills/management/project-status Skill
1★ repoGenerate a weekly Project Status Report covering all active epics and initiatives your team owns. Infers status from actual signals (PRs, issue closures, comments, board movement) rather than requiring manual DRI updates. Surfaces wins, risks, stale projects, and the week ahead. Best run Monday mornings.
philpalmieri/engineering-manager-skills/skills/metrics/team-health-report Skill
1★ repoOrchestration skill that runs all metrics analyses and produces a unified team health dashboard. Combines review network, review cycles, project-people map, contribution velocity, review cards, and 9-box into a single comprehensive report with period-over-period comparison. Use when asked to 'run team health', 'full metrics report', 'quarterly team assessment', or 'team dashboard'.
endalk200/skills/skills/grill-with-docs Skill
no license1★ repoGrill the user relentlessly to sharpen a plan or design while maintaining ADRs and domain glossary documentation. Use when the user asks to "grill with docs" or wants decisions documented during a design interview.
The same file is in 3 other repositories
endalk200/skills/skills/research Skill
no license1★ repoInvestigate a question against high-trust primary sources and capture the findings as a Markdown file in the repo. Use when the user wants a topic researched, docs or API facts gathered, or reading legwork delegated to a background agent.
The same file is in 3 other repositories
endalk200/skills/skills/writing-great-skills Skill
no license1★ repoReference for writing and editing skills well — the vocabulary and principles that make a skill predictable.
The same file is in 11 other repositories
krkn-s/ai-workspace/skills/human-prose Skill
1★ repoWrite and rewrite prose so it reads like a real person wrote it, precise, grounded, occasionally irregular, free of AI tells. Use by default whenever you write, draft, rewrite, summarize, expand, translate, or edit any prose for the user, in French or English, not only when asked to 'humanize' text. It overrides the default urge to produce polished, balanced, generic copy. It covers cleaning invisible characters and stray Markdown, plus a strict voice with no cliché openers ('À l'ère de…', 'In today's world…'), no em-dashes for pauses, concrete detail over abstract faux-depth, no listy or punchy AI structures, asking for real material instead of filling with generalities, then silently self-editing before answering. Déclenche par défaut sur tout texte écrit ou réécrit, en français comme en anglais (rédaction, reformulation, résumé, traduction, nettoyage de prose), même sans demande explicite d'humaniser.