claude/skills/org-announce/SKILL.md
--- name: org-announce description: Draft org-level or company-wide announcements (reporting changes, promotions, departures, strategy, business decisions). Produces email and Slack formats in one invocation. Enforces Josh Lane's register: terse, declarative, no sentiment, no signature, no sycophantic close. Use when asked to draft an announcement, org update, or leadership communication. --- ## When to use Use this skill for two announcement categories: **People changes** — org restructures,
npx skillsauth add lanej/dotfiles claude/skills/org-announceInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use this skill for two announcement categories:
People changes — org restructures, reporting line changes, promotions, departures, role changes
Strategic/business — strategy direction, high-level business decisions, business actions affecting the org
Not in scope: incident comms, product launches/deprecations, external or customer-facing communications.
NEVER use:
ALWAYS:
Subject: [Category] — [Descriptor]
[One sentence: what kind of change and its scope]
Effective [date/immediately][, context if needed]:
- **[Name]**, [title], [reporting/role change — concise]
- **[Name]**, [title], [reporting/role change — concise]
[1–2 sentences: structural rationale — this IS the goal statement. State what the change enables structurally. E.g., "This structure brings X and Y into closer alignment, allowing us to more directly Z."]
[Optional second list with its own header if additional changes are distinct in nature]
Subject: [Brief descriptor of decision or direction]
[One sentence: what was decided or what direction is being taken]
[2–3 sentences: brief context — what prompted it, what it changes. Structural, not motivational.]
[What this means concretely for the org — no aspirational language]
Always produce both formats in a single response:
## Email
Subject: ...
[Body]
---
## Slack
[Body — identical to email body, no subject line, no sign-off]
Input facts:
Output:
Subject: Organizational Update — Aligning Product, Engineering, and Customer Teams
We are making an organizational change to better connect how we build with how we serve customers.
Effective immediately, Engineering, Product, and Customer-facing teams will operate under a single organization.
As part of this:
This structure brings product development and customer experience into closer alignment, allowing us to more directly translate customer signals into product decisions and improvements.
Additional updates:
We are making an organizational change to better connect how we build with how we serve customers.
Effective immediately, Engineering, Product, and Customer-facing teams will operate under a single organization.
As part of this:
This structure brings product development and customer experience into closer alignment, allowing us to more directly translate customer signals into product decisions and improvements.
Additional updates:
data-ai
Delegate research and context-gathering tasks to a sub-agent to protect the primary context window. Use when the user asks to "research X", "look into X", "find out about X", "gather context on X", or any investigative framing where answering requires 2+ searches or multiple sources. Also use proactively before starting substantive work when prior context is unknown. Never run research inline — always delegate.
documentation
--- name: qmd-math description: Math notation conventions for Quarto/EPQ documents rendered via lualatex. Use when: writing or adding a formula, equation, or mathematical expression to a .qmd file; asked about display math, inline math, or LaTeX notation in a QMD/Quarto context; defining a where-clause or variable definitions for an equation; converting prose variable descriptions into structured math notation; fixing math that renders badly in a PDF; using \lvert, \begin{aligned}, \tfrac, \text
development
Trim a prose document (README, design doc, blog post, notes) for readability by cutting redundancy, filler, and dead weight in the author's own words. Invoke with /trim [file path], or /trim alone to be prompted for a file. Not for source code, data files, or summarization.
business
Query and analyze Josh Lane's org headcount from the staffing DuckDB at ~/workspace/areas/staffing/staffing.duckdb. Use when asked about headcount counts, org structure, direct reports, team breakdown, hiring/attrition trends, international employees, salary/pay grade distribution, offboarding lag, or any question about people in Josh's org. Triggers on questions about how many people, who reports to whom, headcount by team/country/level, who joined or left, org size, staffing, headcount trend.