Skip to content
Back to search

claude-skills-pack

SkillWorks with Claude CodeGitHub

Reusable Claude Agent Skills for business teams: client proposals, meeting-to-tasks, code review, brand voice, SEO page briefs.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/nqcthedev--claude-skills-pack/badge.svg)](/listings/nqcthedev--claude-skills-pack)

HTML

<a href="/listings/nqcthedev--claude-skills-pack"><img src="/api/listings/nqcthedev--claude-skills-pack/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Requirements: none for the instructions themselves. Helper scripts need Python 3.9+ (standard library only); `code-review-checklist` also needs git.

Claude Code

Skills are discovered from `~/.claude/skills/` (personal, every project) or `.claude/skills/` inside a repository (shared with the team through git).

git clone <this repo> claude-skills-pack
mkdir -p ~/.claude/skills
cp -r claude-skills-pack/skills/* ~/.claude/skills/            # all five, for you
# or, for one project and everyone who clones it:
mkdir -p .claude/skills && cp -r claude-skills-pack/skills/meeting-to-tasks .claude/skills/

Start a new Claude Code session and ask naturally ("turn these notes into Jira tickets", "review my branch before I merge"). Ask "what skills are available?" to confirm they loaded.

Claude.ai (and Claude Desktop)

Package each skill as a zip with the skill folder at the root:

python3 scripts/package_skills.py            # lints, then writes dist/<skill>.zip

Upload the zip in Claude.ai under **Settings → Capabilities → Skills** (custom skills must be enabled for your plan or organisation; the menu location may change as the product evolves). Code execution must be enabled for the helper scripts to run.

Claude API

Upload a skill with the Skills API, then attach it to Messages API requests through the code execution container. With the Python SDK:

import anthropic
from anthropic.lib import files_from_dir

client = anthropic.Anthropic()

skill = client.skills.create(files=files_from_dir("skills/meeting-to-tasks"))

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    container={"skills": [{"type": "custom", "skill_id": skill.id, "version": "latest"}]},
    tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
    messages=[{"role": "user", "content": "Turn these meeting notes into action items and a Jira CSV: ..."}],
)

Or with cURL (each file's name must include the skill folder):

curl -X POST https://api.anthropic.com/v1/skills \
  -H "x-api-key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2026-10-21" \
  -F "files[]=@skills/meeting-to-tasks/SKILL.md;filename=meeting-to-tasks/SKILL.md" \
  -F "files[]=@skills/meeting-to-tasks/references/output-schema.md;filename=meeting-to-tasks/references/output-schema.md" \
  -F "files[]=@skills/meeting-to-tasks/scripts/tasks_tool.py;filename=meeting-to-tasks/scripts/tasks_tool.py"

Custom skills are shared across the whole API workspace they are uploaded to. See Anthropic's [Skills guide](https://platform.claude.com/docs/en/build-with-claude/skills-guide) for versioning and limits.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 154 lines
  1. # claude-skills-pack
  2. **Five production-ready Agent Skills that teach Claude your team's way of doing recurring business work** - proposals, meeting follow-ups, code reviews, on-brand copy and SEO briefs - with templates, deterministic helper scripts, a CI linter and real worked examples.
  3. ![skills](https://img.shields.io/badge/skills-5-7c5cff) ![lint](https://img.shields.io/badge/skill%20lint-strict%20pass-2ea44f) ![tests](https://img.shields.io/badge/tests-40%20passing-2ea44f) ![deps](https://img.shields.io/badge/runtime%20deps-none%20(stdlib%20Python)-blue) ![License](https://img.shields.io/badge/license-MIT-blue)
  4. ![Proposal produced by the client-proposal skill](docs/screenshots/client-proposal.png)
  5. ## What and why
  6. An [Agent Skill](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) is a folder with a `SKILL.md` (instructions plus YAML frontmatter) and optional scripts, references and templates. Claude sees only each skill's name and description until a task matches; then it loads the instructions and the files it needs. That makes skills the cheapest way to make Claude consistent at work your team repeats: the house style, the checklist and the tooling live in version control instead of in someone's prompt history.
  7. Each skill here follows the same principles:
  8. - **Grounded, not invented.** Proposals label assumptions, action items need a verbatim quote from the meeting, SEO briefs cite fetched page data, copy may only use facts from the brief.
  9. - **Deterministic where it matters.** Validation, CSV export, diff collection and voice checks are Python scripts (standard library only), so the same input always gets the same verdict.
  10. - **Customisable without touching the instructions.** Teams edit a style guide, a checklist or a voice guide; the `SKILL.md` stays generic.
  11. ## The skills
  12. | Skill | What it does | Bundled resources |
  13. |---|---|---|
  14. | [`client-proposal`](skills/client-proposal) | Client brief, RFP or call notes → proposal in house style: scope (in/out), deliverables, timeline, priced options, assumptions, risks, next steps; plus cover email and open questions. | Proposal template, house style guide, pricing guidance |
  15. | [`meeting-to-tasks`](skills/meeting-to-tasks) | Transcript or notes → decisions, action items (owner, due date, priority, evidence quote), open questions as Markdown + JSON; validated, then exported to Jira, Asana, Notion or generic CSV. | `tasks_tool.py` (validate, quote-check against transcript, export), output schema |
  16. | [`code-review-checklist`](skills/code-review-checklist) | Branch, PR, staged changes or pasted diff → verdict, severity-ranked findings with file:line and fixes, checklist coverage table. Teams override the checklist with `.code-review-checklist.md`. | `gather_diff.py` (diff, stats, commit list, risk flags: secrets, SQL/shell injection patterns, debug code, untested source...), default checklist, review template |
  17. | [`brand-voice-writer`](skills/brand-voice-writer) | Voice guide + brief → on-brand LinkedIn/X/Instagram posts, emails, newsletters, product and ad copy, each scored before hand-over. Can build the voice guide from example texts. | `check_draft.py` (banned words, sentence length, emoji, hashtags, reading ease, channel limits), voice-guide template, self-check rubric, channel formats |
  18. | [`seo-page-brief`](skills/seo-page-brief) | Keyword + competitor URLs → content brief: intent, title/meta/H1/slug, outline, consensus topics, content gaps, length target, FAQs, internal links, schema, competitor table. Uses the [web-insights MCP server](#works-with-web-insights-mcp) when connected. | Brief template, web-insights tool recipes |
  19. ## Examples (real work, not mock-ups)
  20. The [`examples/`](examples) folder contains real inputs and the outputs produced by following each skill, including the helper scripts' actual output. All businesses and people are fictional.
  21. | | |
  22. |---|---|
  23. | ![meeting-to-tasks](docs/screenshots/meeting-to-tasks.png) | ![code review](docs/screenshots/code-review.png) |
  24. | ![brand voice](docs/screenshots/brand-voice.png) | ![seo brief](docs/screenshots/seo-brief.png) |
  25. - **client-proposal** - a dental chain's email brief becomes a 3-option proposal; tables are machine-checked to add up ([output](examples/client-proposal/output/proposal-brightsmile-dental.md)).
  26. - **meeting-to-tasks** - a kickoff call transcript becomes 7 decisions, 10 action items and 3 open questions; every quote is verified against the transcript and the Jira/Asana/Notion CSVs are generated by the script ([output](examples/meeting-to-tasks/output/tasks.md)).
  27. - **code-review-checklist** - a Flask PR adding SMS cancel links gets 13 findings, including SQL injection, a committed API key and guessable tokens; all 7 automated risk flags are confirmed or dismissed ([output](examples/code-review-checklist/output/REVIEW.md), reproducible with [`reproduce.sh`](examples/code-review-checklist/reproduce.sh)).
  28. - **brand-voice-writer** - three launch pieces for a coffee subscription; the checker failed two first drafts for over-long sentences and the rubric caught one invented claim, both fixed ([voice check](examples/brand-voice-writer/output/voice-check.md)).
  29. - **seo-page-brief** - 12 web-insights MCP calls on three competitor pages produce a brief that also catches a contradiction on the brand's own page ([brief](examples/seo-page-brief/output/brief-cold-brew-ratio.md)).
  30. ## Install
  31. Requirements: none for the instructions themselves. Helper scripts need Python 3.9+ (standard library only); `code-review-checklist` also needs git.
  32. ### Claude Code
  33. Skills are discovered from `~/.claude/skills/` (personal, every project) or `.claude/skills/` inside a repository (shared with the team through git).
  34. ```bash
  35. git clone <this repo> claude-skills-pack
  36. mkdir -p ~/.claude/skills
  37. cp -r claude-skills-pack/skills/* ~/.claude/skills/ # all five, for you
  38. # or, for one project and everyone who clones it:
  39. mkdir -p .claude/skills && cp -r claude-skills-pack/skills/meeting-to-tasks .claude/skills/
  40. ```
  41. Start a new Claude Code session and ask naturally ("turn these notes into Jira tickets", "review my branch before I merge"). Ask "what skills are available?" to confirm they loaded.
  42. ### Claude.ai (and Claude Desktop)
  43. Package each skill as a zip with the skill folder at the root:
  44. ```bash
  45. python3 scripts/package_skills.py # lints, then writes dist/<skill>.zip
  46. ```
  47. Upload the zip in Claude.ai under **Settings → Capabilities → Skills** (custom skills must be enabled for your plan or organisation; the menu location may change as the product evolves). Code execution must be enabled for the helper scripts to run.
  48. ### Claude API
  49. Upload a skill with the Skills API, then attach it to Messages API requests through the code execution container. With the Python SDK:
  50. ```python
  51. import anthropic
  52. from anthropic.lib import files_from_dir
  53. client = anthropic.Anthropic()
  54. skill = client.skills.create(files=files_from_dir("skills/meeting-to-tasks"))
  55. response = client.messages.create(
  56. model="claude-opus-5-5",
  57. max_tokens=16000,
  58. container={"skills": [{"type": "custom", "skill_id": skill.id, "version": "latest"}]},
  59. tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
  60. messages=[{"role": "user", "content": "Turn these meeting notes into action items and a Jira CSV: ..."}],
  61. )
  62. ```
  63. Or with cURL (each file's name must include the skill folder):
  64. ```bash
  65. curl -X POST https://api.anthropic.com/v1/skills \
  66. -H "x-api-key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2026-10-21" \
  67. -F "files[]=@skills/meeting-to-tasks/SKILL.md;filename=meeting-to-tasks/SKILL.md" \
  68. -F "files[]=@skills/meeting-to-tasks/references/output-schema.md;filename=meeting-to-tasks/references/output-schema.md" \
  69. -F "files[]=@skills/meeting-to-tasks/scripts/tasks_tool.py;filename=meeting-to-tasks/scripts/tasks_tool.py"
  70. ```
  71. Custom skills are shared across the whole API workspace they are uploaded to. See Anthropic's [Skills guide](https://platform.claude.com/docs/en/build-with-claude/skills-guide) for versioning and limits.
  72. ## Customise for your team
  73. | Skill | Edit this | Typical changes |
  74. |---|---|---|
  75. | client-proposal | `references/style-guide.md`, `assets/proposal-template.md` | Studio name, day rates, contingency, payment terms, voice, section order |
  76. | meeting-to-tasks | `references/output-schema.md` | Priority scale, labels, extra CSV columns |
  77. | code-review-checklist | `.code-review-checklist.md` in *your* repository (copy `references/default-checklist.md`) | Team rules, framework-specific items, sections marked `(n/a)` |
  78. | brand-voice-writer | Your voice guide (from `assets/voice-guide-template.md`) | Traits, vocabulary, banned words, channel rules in the `voice-rules` block |
  79. | seo-page-brief | `assets/brief-template.md` | Brief sections your writers expect |
  80. ## Quality checks
  81. ```bash
  82. pip install -r requirements-dev.txt # PyYAML, for the linter
  83. python3 scripts/lint_skills.py --strict # lint every skill
  84. python3 -m unittest discover -s tests # 40 tests: linter, scripts, example consistency
  85. python3 scripts/package_skills.py # build upload zips into dist/
  86. ```
  87. ![lint and tests](docs/screenshots/lint-and-tests.png)
  88. `lint_skills.py` checks what breaks skills in practice: frontmatter present and valid YAML; only allowed keys (`name`, `description`, `license`, `allowed-tools`, `metadata`, `compatibility`); name in kebab-case, at most 64 characters, matching the folder and free of reserved words; description present, at most 1,024 characters, no angle brackets, long enough and containing trigger guidance; body under 500 lines; every file referenced from `SKILL.md` exists; every bundled file is referenced; bundled Python compiles; exactly one `SKILL.md`; under the 30 MB upload limit. GitHub Actions runs the linter in strict mode, the tests and the packager on every push and pull request ([`ci.yml`](.github/workflows/ci.yml)).
  89. ## Works with web-insights-mcp
  90. `seo-page-brief` is designed to pair with **web-insights-mcp**, a companion MCP server (separate repository) that provides `fetch_page`, `crawl_site`, `seo_audit`, `site_seo_audit`, `extract_structured` and `compare_pages` with SSRF protection. The SEO example's research was recorded through that server; without it, the skill falls back to any web fetch tool or pasted content.
  91. ## Security notes
  92. - Helper scripts are read-only: `gather_diff.py` never modifies the repository, and the other scripts only write the files you name. No script makes network calls.
  93. - `gather_diff.py` reports *possible* secrets with the matched line so a reviewer can act; avoid pasting its output into public places when it flags a real credential.
  94. - Skills are instructions Claude follows. Review any skill (including these) before installing it, as you would a dependency, and only install skills from sources you trust.
  95. - On the API, custom skills are visible to everyone with access to the workspace; keep sensitive house data (rates, client names) out of shared workspaces.
  96. ## Limitations (honest list)
  97. - **Skill quality depends on the model and context.** The scripts are deterministic; the writing and judgement are not. The rubric and validators reduce, but do not eliminate, mistakes - keep a human in the loop for anything sent to clients.
  98. - **Triggering was not measured with an automated eval.** Descriptions follow Anthropic's skill-authoring guidance (what + when, specific trigger phrases), and the examples were produced by following each `SKILL.md` step by step, but no trigger-rate benchmark was run.
  99. - **Examples use fictional data.** The SEO example's competitor pages are fictional fixtures served locally (the build environment had no internet access); the method is the same for live pages.
  100. - **Risk flags are heuristics.** `gather_diff.py` uses regular expressions; it misses obfuscated secrets and can flag safe code. It is a checklist for the reviewer, not a security scanner.
  101. - **Tracker imports vary.** CSV columns follow each tool's importer conventions at the time of writing; you may still need to map fields in the import wizard (Jira date format, Asana assignee emails, Notion property types).
  102. - **Reading ease is English-only.** `check_draft.py`'s readability score and syllable counter assume English text.
  103. ## License
  104. MIT © Cuong Nguyen
  105. ---
  106. Built by NQC The Dev — AI developer. Available for hire on Fiverr: https://www.fiverr.com/cuongnqxx

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.