Skip to content

skills: add executive-summary + skill-authoring checklist#48

Merged
devstefancho merged 3 commits into
mainfrom
worktree-executive-summary-skill
Jun 16, 2026
Merged

skills: add executive-summary + skill-authoring checklist#48
devstefancho merged 3 commits into
mainfrom
worktree-executive-summary-skill

Conversation

@devstefancho

Copy link
Copy Markdown
Owner

What

Adds a new executive-summary skill and a repo-wide skill-authoring checklist, derived from analyzing the user's past Claude Code prompts.

skills/productivity/executive-summary/

Compresses a long output/report/analysis into a one-page CEO/CTO brief — conclusion first, key points only, technical detail translated into business impact, without dropping the facts a decision needs.

  • Trigger phrases mined from real prompts: 내용이 너무 많아서 읽기 힘들다, 한눈에 안 들어온다, CEO/CTO에게 보고하듯, 한 페이지로 정리해줘, 핵심만 압축, 정리해줘, 요약해줘.
  • Bundles a self-contained HTML one-pager template (templates/onepager.html) for the "html로 열어줘" path.
  • Follows the repo house style (one-line essence + invariant → ## Hard Rules → tables → ## Anti-patterns## Boundaries), 66 lines.

docs/skill-authoring-checklist.md

Pre-flight gate distilled from AGENTS.md conventions + session-learned pitfalls:

  • triggers belong in description only (no When this fires body section)
  • one idea = one place (no triple-restating across principles/section/anti-patterns)
  • run a functional sanity test before declaring done

AGENTS.md now requires reading the checklist before creating/editing any skill (conventions intro + Adding-a-skill step 0), and lists executive-summary under productivity.

Verification

  • jq valid; both executive-summary and github-issue (merged from main) registered in plugin.json.
  • All registered skill dirs have SKILL.md.
  • executive-summary frontmatter parses as valid YAML, description 371 chars (≤1024).
  • Functional sanity test: ran the skill on a realistic long status report; produced a conclusion-first one-page brief preserving load-bearing numbers.

Notes

🤖 Generated with Claude Code

devstefancho and others added 3 commits June 16, 2026 23:56
Compresses a long output/report/analysis into a one-page brief for a
decision-maker: conclusion first, key points only, technical detail
translated into business impact. Bundles a self-contained HTML one-pager
template for the "html로 열어줘" path. Registered in plugin.json.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
New docs/skill-authoring-checklist.md is a pre-flight gate distilled from
the AGENTS.md conventions plus session-learned pitfalls (triggers belong
in description only, no triple-restating a rule, run a functional sanity
test before "done"). AGENTS.md now mandates reading it before creating or
editing any skill, and lists executive-summary under productivity.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…mmary-skill

# Conflicts:
#	.claude-plugin/plugin.json
#	AGENTS.md
@vercel

vercel Bot commented Jun 16, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
claude-plugins Ready Ready Preview, Comment Jun 16, 2026 2:58pm

@devstefancho devstefancho merged commit 5f1f0a7 into main Jun 16, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant