How to use the Staff-Engineer Promotion Case Deck agent skill

What does the Staff-Engineer Promotion Case Deck skill make the agent do?

An agent skill is a folder of instructions that an AI agent reads when a request matches the skill. This one teaches the agent to produce a slide-style HTML presentation arguing for a staff-engineer promotion. The case is organised around scope, specific proof moments, artifacts, and impact.

The deck uses a white, magazine-style template. Speaker notes are placed in separate notes elements so they stay out of the visible slides. Before drafting, the agent is instructed to ask for missing essentials: audience, decision target, source materials, deadline and key numbers.

How do you install the skill?

Download the skill ZIP from the item page. The package lists two files: SKILL.md and example.html.

For a personal install, unzip the package into ~/.claude/skills/. For a single project, unzip it into that project's .claude/skills/ folder instead.

Alternatively, upload the skill in the Claude apps under Settings → Capabilities → Skills.

• Personal: ~/.claude/skills/
• Project only: the project's .claude/skills/ folder
• Claude apps: Settings → Capabilities → Skills, then upload

How do you trigger the skill with a natural request?

You do not need special syntax. Describe what you want in plain words that match the skill's triggers. The skill's listed triggers include promotion, self-review, career, portfolio, html deck and html slides.

Give the agent your subject and audience in the same message if you can. The skill will still ask for anything essential that is missing.

• I'm preparing my staff-engineer promotion packet as an HTML deck for my manager.
• Help me build a year-end self-review deck in HTML slides for the calibration committee.
• Turn my promotion notes into a career portfolio deck with speaker notes.

What should you prepare before asking?

The skill works best when you already have source material. Gather the documents, project summaries, and numbers that support your case. The deck is only as credible as what you supply, so include concrete proof rather than summaries you cannot back up.

Know your audience, the decision you want, your deadline, and the figures you must keep. The agent will ask for these before drafting, so having them ready speeds things up.

• Audience (for example, your manager or a calibration committee)
• Decision target (what you want them to decide)
• Source materials and the numbers that must stay accurate
• Deadline

What does the skill need, and what are the safety notes?

The item page lists no required dependencies. The skill does not run scripts and does not use the network, according to its listing.

The skill does not verify claims. It structures whatever you provide, so it will not check facts or detect inflated achievements. Review every statement in the deck yourself before sharing it.

Template files are referenced by paths in the upstream html-ppt repository. The downloaded package as listed contains only SKILL.md and example.html, so the referenced template folders may be missing if you use only the ZIP. Check whether the files your agent needs are present before relying on the template.

What tips help you get a stronger deck?

Ask the agent to build the case around specific proof moments rather than general responsibilities. A critic pass in the skill's example prompt checks whether the evidence makes the claim feel earned.

Keep speaker notes separate from slide text. The skill places them in dedicated notes elements, which keeps your talking points out of the audience's view.

Use the output as a draft. Edit the wording so it matches how you actually work and the facts you can defend in a review.

• Name concrete artifacts, decisions and measured impact.
• Supply real numbers and say which ones must not change.
• Ask for a critique of weak claims before you finalise.