Skip to content
cccskills
FreePublished on GitHub

mk:story-sizer

Pre-ticket Fibonacci sizing for a paste-mode batch of user stories. Default mode is advisory-only (writes a Story Sizing Report). Opt-in `--auto-create` delegates ticket creation to mk:jira-issue + mk:jira-collaborate with mandatory dry-run + single batch confirmation gate. NOT for single-ticket estimation (mk:jira-estimator); NOT for sprint capacity (mk:planning-engine).

The English summary is being prepared. Showing the original description.

Works withJira
See how to install

Files included (14)

  • SKILL.md5.1 KB
  • assets/sizing-report-template.md2.3 KB
  • references/auto-create-execution.md5.0 KB
  • references/auto-create-gating.md5.0 KB
  • references/injection-patterns.md2.1 KB
  • references/input-adapter.md3.9 KB
  • references/orchestration.md3.3 KB
  • references/report-writer.md3.0 KB
  • references/sizing-heuristics.md6.4 KB
  • scripts/check-auto-create-gating.py8.4 KB
  • scripts/execute-auto-create.py10.5 KB
  • scripts/parse-paste-stories.py6.3 KB
  • scripts/score-story.py10.7 KB
  • scripts/write-sizing-report.py9.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

mk:story-sizer

Forks to the story-sizer agent (system prompt at .claude/agents/story-sizer.md). v1 ships paste-mode only: the user provides a markdown block of stories, the agent applies heuristics, and a Story Sizing Report is written to tasks/reports/story-sizing-{YYMMDD}-{slug}.md. No Jira side effects in default mode.

Triggers

  • "size these stories"
  • "rough-size from spec"
  • "pre-ticket sizing for these user stories"
  • "Fibonacci size this story list"
  • "story points for these candidates before we create tickets"

Commands

ModeInvocationSide effects
Default/mk:story-sizer --paste [--scout] [--story <id>]Writes Story Sizing Report only. No Jira calls.
Auto-create/mk:story-sizer --paste --auto-create --project <KEY> [--epic <KEY>]After dry-run + single confirmation, delegates ticket creation per story.

Input

Paste-mode contract: see references/input-adapter.md for the strict markdown template, StoryRecord schema, validation rules, and failure modes. The parser is scripts/parse-paste-stories.py (deterministic; SHA-256 source-hash recorded for the auto-create source-consistency check).

Heuristics

Fibonacci sizing rules: see references/sizing-heuristics.md for complexity dimensions, scoring tables, inconsistency detection, split-proposal triggers, and DoR advisory. Scorer is scripts/score-story.py (integer-arithmetic over text-derived counts; same input → same numeric output).

Output

Report template + slot semantics: references/report-writer.md. Renderer is scripts/write-sizing-report.py. Default path: tasks/reports/story-sizing-{YYMMDD}-{slug}.md. Idempotency by source_hash — repeated runs on the identical paste body re-prompt before overwriting.

Per-story suggested create commands obey the v1 field whitelist: --project, --type, --summary, --story-points, --description, optional --epic, --components, --labels. No --assignee, --priority, --sprint, --blocks, or --custom-fields in v1.

Orchestration

End-to-end default flow + --scout extract-or-prompt pattern + filtering rules: references/orchestration.md. Story-sizer NEVER auto-invokes /mk:scout — it extracts existing session output or prompts the user to run scout first.

Auto-create (opt-in)

--auto-create --project <KEY> [--epic <KEY>] runs 5 pre-flight checks (NO_ACS, Rule-1 injection, length cap, duplicate suspect via mk:jira-search, source-hash mismatch). If all pass, a markdown dry-run table renders + a single AskUserQuestion gate decides ship-or-abort. Gating rules: references/auto-create-gating.md. Rule-1 inventory copy: references/injection-patterns.md. Gating check: scripts/check-auto-create-gating.py.

See also

  • Agent: ../../agents/story-sizer.md
  • Peer intelligence: mk:jira-evaluator (post-ticket complexity), mk:jira-estimator (post-ticket estimation), mk:planning-engine (sprint capacity)
  • Peer execution (delegated): mk:jira-issue (create), mk:jira-collaborate (audit comment via --internal)
  • Shared: ../jira/references/estimation-guide.md (Fibonacci heuristic conventions)

Gotchas

  • The source_hash recorded in the report header is the SHA-256 of the exact paste body. If you edit the paste locally between sizing and --auto-create, the source-consistency check will ABORT — re-paste the modified body and re-run --paste to regenerate the report.
  • --scout does not auto-invoke /mk:scout. Run /mk:scout first when you want codebase signals; otherwise the report carries [NO_CODEBASE_CONTEXT].
  • DoR advisory only appears when mk:agent-detector loaded .claude/rules-conditional/agile-story-gates.md for the current session.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Use this skill to generate well-branded interfaces and assets for MeowKit (AI Agent Toolkit for Claude Code), either for production or throwaway prototypes/mocks/etc. Contains essential design guidelines, colors, type, fonts, assets, and UI kit components for prototyping.

The English summary is being prepared. Showing the original description.

ngocsangyem/MeowKit15Updated Jul 28, 2026

Turn a raw idea into ONE honest recommendation: interview one question at a time until confirmed, then give a verdict with trade-offs and a checklist. Not for options or debate.

The English summary is being prepared. Showing the original description.

ngocsangyem/MeowKit15Updated Jul 28, 2026

Browser automation CLI for agents: navigate, click/fill, screenshot, extract data, test apps, Electron/Slack, cloud browsers. NOT for the user's real Chrome profile/cookies (mk:chrome-profile).

The English summary is being prepared. Showing the original description.

ngocsangyem/MeowKit15Updated Jul 28, 2026

Detects the right agent and complexity tier at Phase 0 orient; runs first in every workflow. NOT for runtime agent routing inside a single skill.

The English summary is being prepared. Showing the original description.

ngocsangyem/MeowKit15Updated Jul 28, 2026

Angular v20+ patterns: components, signals, services, forms, routing, HTTP, testing, SSR. Auto-activates on .ts files in Angular projects (angular.json detected).

The English summary is being prepared. Showing the original description.

ngocsangyem/MeowKit15Updated Jul 28, 2026

Design and review durable REST, GraphQL, RPC, or event API contracts: shape, compatibility, pagination, error semantics. Discovers existing consumers first. Not implementation, schema, or release.

The English summary is being prepared. Showing the original description.

ngocsangyem/MeowKit15Updated Jul 28, 2026

See all skills by ngocsangyem

Report a problem with this skill