Skip to content
Skills Library
Marketing & content · Writing

case-study

/case-study

Turns project notes, images, a deck or links into a portfolio case study - a responsive web page, a PDF and Markdown ready to paste into a portfolio site, Behance, Notion or LinkedIn - covering the challenge, insight, idea, process, craft, results and credits. Can tailor the story to a target company or role. Never invents results or quotes. Use when someone asks for a case study, portfolio write-up, project page, project story, or help presenting past work for a job or a pitch. Usage - /case-study followed by the project name, with notes or images attached.

Repository
case-study ↗
Licence
MIT
Last repository change
09.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
12
Scripts
6
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 09.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 6 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/audit.js, scripts/contact_sheet.py, scripts/fonts.py, scripts/render.cjs, scripts/render.py, scripts/tokens.py

What it does and when to use it

Turns project notes, images, a deck or links into a portfolio case study - a responsive web page, a PDF and Markdown ready to paste into a portfolio site, Behance, Notion or LinkedIn - covering the challenge, insight, idea, process, craft, results and credits. Can tailor the story to a target company or role. Never invents results or quotes. Use when someone asks for a case study, portfolio write-up, project page, project story, or help presenting past work for a job or a pitch. Usage - /case-study followed by the project name, with notes or images attached.

Original author description

Turns project notes, images, a deck or links into a portfolio case study - a responsive web page, a PDF and Markdown ready to paste into a portfolio site, Behance, Notion or LinkedIn - covering the challenge, insight, idea, process, craft, results and credits. Can tailor the story to a target company or role. Never invents results or quotes. Use when someone asks for a case study, portfolio write-up, project page, project story, or help presenting past work for a job or a pitch. Usage - /case-study followed by the project name, with notes or images attached.

How it works

  1. Usage
  2. Ask once for what only the person knows
  3. Hard rules
  4. Workflow
Original SKILL.md headings · 51 lines, 710 words
SKILL.md preview
---
name: case-study
description: Turns project notes, images, a deck or links into a portfolio case study - a responsive web page, a PDF and Markdown ready to paste into a portfolio site, Behance, Notion or LinkedIn - covering the challenge, insight, idea, process, craft, results and credits. Can tailor the story to a target company or role. Never invents results or quotes. Use when someone asks for a case study, portfolio write-up, project page, project story, or help presenting past work for a job or a pitch. Usage - /case-study followed by the project name, with notes or images attached.
---

# Case Study

Turn the raw material of a project (notes, images, a deck, links, a client email) into a case study that shows how the person thinks and what changed because of their work. One story, three formats: a web page, a PDF, and Markdown.

## Usage

```
/case-study <project name> [for <company or role>] [short | long]
```

Attach whatever exists: images, a PDF deck, notes, press links, results. Plain requests work too:

- "Write a case study for the Sphere partnership launch. Notes and images attached."
- "Turn this deck into a portfolio case study, short version."
- "Case study for my art car project, aimed at experiential agency roles."
- "Rewrite this case study for a Netflix design lead application." (attach the existing one)

**Length.** Default is about 600–900 words with 6–10 images. "short" is a 150–250 word card for a portfolio grid or LinkedIn post. "long" adds process detail for a design-team audience.

## Ask once for what only the person knows

Before writing, collect: their role and what they personally did (versus the team), the team and collaborators to credit, the client and whether the client can be named, results (numbers, press, awards, quotes) with where they come from, and what's under NDA. If anything is missing, ask in one short message, then continue with what's available and mark gaps in the reply.

**Files.** `<skill-dir>` means this skill's folder, the one holding this SKILL.md. Templates are in `assets/`, scripts in `scripts/`, and the shared PDF steps (fonts, colors, render, check) are in `references/rendering.md`.

## Hard rules

- **Never invent results, quotes, numbers, clients or awards.** Use only what the person gave or what you verified in a public source (cite it). Without results, write about what the work made possible and say what to add.
- **Their role, clearly.** Say what the person did, and credit others by name or role. "I led" only where they led.
- **Respect confidentiality.** Leave out anything under NDA or unreleased. Ask if unsure whether a client can be named; offer an anonymized version ("a global sports and entertainment company").
- **Images are theirs.** Use only images the person provided or owns the rights to show. Write alt text and a caption for each. Don't pull client or brand images from the web into the case study.
- **Show the thinking.** Every case study answers: what was the problem, what did you notice, what did you decide and why, what did you make, what changed.
- No Beautiful Engine credit or other third-party branding: the case study belongs to the person.

## Workflow

1. **Gather and read** everything attached. If it's a deck or PDF, pull out the key frames as images (`pdftoppm -r 110 -png deck.pdf frame`) and pick the strongest.
2. **Find the story** in 4 sentences: the challenge, the insight, the idea, the outcome. That becomes the dek and the section leads.
3. **Tailor** (when a company or role is given): lead with the part of the work that matches their needs, use their vocabulary where it honestly fits, and choose the images that prove it. If a Company Brief for that company is in the conversation, use it.
4. **Write `case-study.md`**: title, one-line dek, a meta block (client, role, team, year, disciplines), then Challenge, Insight, Idea, Process, Craft, Results, Credits. Short paragraphs, image placements with captions, and pull quotes only if real.
5. **Build the page** from `assets/case-study-template.html`:
   - copy the images into `images/` beside it;
   - set colors and fonts with the person's own portfolio style if they have one (look at their site), otherwise neutral, letting the work carry the color;
   - for the PDF: link fonts with `scripts/fonts.py` and render per references/rendering.md;
   - for the web version: save a copy as `index.html` with the FONT LINKS replaced by a Google Fonts `<link>` for the same families, so it works when hosted.
6. **Render, audit, check** the PDF contact sheet, and open the web page at phone width if a browser is available.
7. **Deliver** the PDF, the web folder (`index.html` + `images/`, zipped), and `case-study.md`. In the reply: the 4-sentence story, anything left out for confidentiality, and the facts or numbers that would make it stronger.

Output names: `<Project>-Case-Study.pdf`, `<Project>-Case-Study-web.zip`, `<Project>-Case-Study.md`.
Files in this package (12)
  • README.md 2 KB
  • SKILL.md 5 KB
  • assets/base.css 16 KB
  • assets/case-study-template.html 6 KB
  • assets/deck.css 5 KB
  • references/rendering.md 4 KB
  • scripts/audit.js 2 KB
  • scripts/contact_sheet.py 2 KB
  • scripts/fonts.py 3 KB
  • scripts/render.cjs 2 KB
  • scripts/render.py 4 KB
  • scripts/tokens.py 7 KB

Versions

RepositoryScoreLicence
This page · BeautifulEngine/case-study100MIT
matteotitta/genesys-skills100MIT
darkroomengineering/cc-settings100MIT
Jakeschincariol/whale-skill100MIT
matteotitta/genesys-skills100MIT
naveedharri/benai-skills100MIT
Owl-Listener/designer-skills100MIT
calven-ai/marketing-as-code90MIT

Database snapshot: 13.11.2026 · package version b8e380add547 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90portfolio-case-study
    Turns a finished web design/Webflow project into a portfolio case study for Upwork, Fiverr, a personal portfolio site, LinkedIn or Behance. ALWAYS use when the user says "case study", "studiu de caz", "portofoliu", "portfolio item", "descriere proiect pentru Upwork", "Project…
  • 90case-study-writer
    Writes a case study from a project's real logs, test results and Break Report, structured as challenge, what was built, how it was tested, results and known limits, with every number sourced and demo work labelled as demo work. Use when a project is finished and needs to become…
  • 100graphic-case-study
    Generates a professionally designed case study PDF for B2B SaaS sales and marketing. Supports 7 page layouts, 9 style presets, 1-4 page output. Trigger when user says "create a case study", "write a customer story", "make a case study PDF", "design a success story", "turn this…
  • 100portfolio-case-study-writer
    Transform resume bullets into detailed portfolio case studies with context, action, and outcome. Use when the user mentions portfolio, case study, project write-up, or expanding a resume bullet into a longer narrative.
  • 100customer-case-study
    Turn a customer interview transcript, call recording notes, CRM notes or a success manager's summary into a customer case study (customer success story) with a problem–solution–results structure, real quotes, and a short version for sales decks and social posts. Use when a PMM,…
  • 100case-study-builder
    Creates professional case studies, engagement summaries, and project summaries. Use when the user wants to create a 'case study,' 'client success story,' 'engagement summary,' 'project summary,' or 'portfolio piece.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.