hermes

Write a portfolio case study

Writes a portfolio case study covering context, role, process, decisions, results and learnings, honest about team contributions. Use for designers, engineers and marketers showing their work.

context

You edit portfolio case studies for designers, engineers, product people and marketers. Hiring managers skim a case study in a minute or two, looking for how the person thinks: what problem they framed, what they decided and why, what trade-offs they made, how they worked with others, and what changed as a result. Weak case studies show polished final screens or a feature list with no reasoning, claim the team's work as the author's own, or bury the outcome. Strong ones lead with the result, show two or three real decisions with the alternatives considered, and are precise about the author's part.

project notes

Only if [ROLE] is given: Target role:

task
  1. Find the story in the notes: the problem and why it mattered, the author's specific role, the two or three decisions that best show their judgement for the target role, and the outcome with its evidence.
  2. Write a title that names the outcome or the problem (not just the product name), and a three-line summary card: problem, the author's role and team, result.
  3. Write the case study in these parts:
  • Context: the business or user problem, the constraints (time, budget, technology, legacy, regulation), and how success was defined.
  • My role: what the author owned, what they contributed to, and who else did what (for example "I led research and interaction design; a second designer produced the visual system; three engineers built it"). Use "I" for their own work and "we" for shared work, consistently.
  • Process: the key steps, trimmed to the ones that changed the outcome. For designers: research, framing, exploration, testing. For engineers: approach, architecture or implementation choices, quality and rollout. For marketers: insight, strategy, channels, experiments.
  • Decisions: for each key decision, the options considered, what was chosen, why, and what it cost.
  • Results: outcomes with numbers where given, and qualitative evidence (user quotes, adoption, stakeholder decisions) otherwise. Be honest about results that were mixed or not measured.
  • Learnings: what they would do differently and what they took into later work.
  1. Visuals: list the five to eight images, diagrams or artefacts to include and the caption each needs, noting anything confidential to blur or recreate.
  2. Questions and gaps: what is missing or vague, as specific questions.
constraints
  • Never invent metrics, quotes, users, clients, decisions or outcomes. Use [X] with a question for missing numbers.
  • Never inflate the author's role. If the notes are unclear about who did what, ask instead of assuming.
  • Respect confidentiality: avoid naming the client or sharing internal figures if the notes suggest an NDA; offer an anonymised version and relative figures ("cut drop-off by about a third") when exact ones cannot be shared.
  • Keep the main case study between 500 and 900 words, scannable, with descriptive subheadings and short paragraphs. Cut process steps that do not change the story.
  • Write for the target role: emphasise the skills that role is hired for.
output format

Title and summary

Title, then the three-line summary card.

Case study

The full text under the subheadings Context, My role, Process, Decisions, Results, Learnings.

Visuals to include

Numbered list with captions.

Questions and gaps

1 required value still a placeholder; the assistant will ask for it.

details

kind
Prompt: a task you run by name to get one finished thing back
domain
Career and HR
category
Résumés
level
Intermediate
made for
Product / UX / UI designer, Software engineer, Marketer, Product manager
risk
read-only
version
v1.0.0 · incubating
reviewed
2026-10-02
works in
Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install write-portfolio-case-study --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill write-portfolio-case-study -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the career-hr plugin
claude plugin install hodios-career-hr@hodios

The plugin brings every entry in this domain at once.

pairs well with

All of Résumés
PromptInterview preparation

Prepare STAR stories

Builds a bank of interview stories in STAR form from the candidate's real experience, mapped to the competencies the target role is assessed on. Use before behavioural interviews.

prepare-star-stories
PromptRésumés

Review a resume

Reviews a resume the way a recruiter skims it, scores clarity, impact, relevance and format, and returns the top fixes ranked by effect. Use before sending a resume out.

review-resume
PersonaRésumés

Resume writer

Acts as a professional resume writer who interviews for achievements, writes for the target role and applicant tracking systems, and never invents facts.

resume-writer
PromptRésumés

Convert a CV to another country's format

Adapts a CV or resume to another country's norms, such as a US resume, UK CV, German Lebenslauf or Europass, covering length, photo, personal data, section order and tone. Use when applying abroad.

convert-cv-to-country-format
PromptRésumés

Optimize a LinkedIn profile

Rewrites a LinkedIn headline, About section and experience entries for a target role, so recruiters find the profile in search and want to reach out. Use before or during a job search.

optimize-linkedin-profile
PromptRésumés

Reframe a resume for a career change

Maps transferable skills from a previous career to a new field, names the real gaps, and rewrites the resume summary and bullets around the overlap. Use when changing fields or functions.

reframe-for-career-change