Skip to content

Add Claude Code skills for common tasks#84

Merged
silv-io merged 2 commits intomainfrom
silv-io/flc-432
Mar 9, 2026
Merged

Add Claude Code skills for common tasks#84
silv-io merged 2 commits intomainfrom
silv-io/flc-432

Conversation

@silv-io
Copy link
Copy Markdown
Member

@silv-io silv-io commented Mar 8, 2026

Motivation

Add Claude Code skills to encode architectural patterns and reduce friction when scaffolding new features. Claude doesn't always follow CLAUDE.md reliably for multi-step scaffolding tasks — skills with explicit step-by-step instructions and anti-pattern lists address this.

Changes

  • /add-command — scaffolds a new CLI subcommand (cmd wiring, domain logic, tests), asks clarifying questions first, challenges architectural decisions
  • /add-event — adds a new output event type with format parity across plain and TUI sinks
  • /add-component — scaffolds a new Bubble Tea TUI component with styles and tests
  • /review-pr — reviews a PR against the lstk architectural checklist
  • /create-pr — creates a PR with conventional Motivation/Changes/Tests/Todo/Related format, fetches Linear ticket context via MCP
  • Updated CLAUDE.md with skills reference section

Tests

Manual verification — invoked skills in a live session to validate structure and behavior.

Todo

  • Revisit scaffolding skills after more usage to see if they need tuning
  • Consider adding more skills as patterns emerge

Related

@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Mar 8, 2026

📝 Walkthrough

Walkthrough

Adds five new AI assistant skill documentation files under .claude/skills/ (add-command, add-component, add-event, create-pr, review-pr) and updates CLAUDE.md to reference these skills. The skill files provide step-by-step scaffolding and workflow guidance for CLI, TUI, events, and PR tasks.

Changes

Cohort / File(s) Summary
Claude Skills — command/event/component guidance
​.claude/skills/add-command/SKILL.md, ​.claude/skills/add-event/SKILL.md, ​.claude/skills/add-component/SKILL.md
Three new skill guides detailing step-by-step patterns for adding CLI subcommands, output events, and Bubble Tea TUI components, including conventions for output/error handling, event formatting, UI wiring, testing, and anti-patterns.
Claude Skills — PR workflows
​.claude/skills/create-pr/SKILL.md, ​.claude/skills/review-pr/SKILL.md
Two new skill guides for creating and reviewing PRs: create-pr includes a YAML front-matter workflow that integrates git, gh, and Linear MCP; review-pr provides a multi-section PR checklist and verdict format.
Main Documentation
CLAUDE.md
Adds a "Claude Skills" section (duplicated in two locations) linking to the five new skill guides.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

🚥 Pre-merge checks | ✅ 2
✅ Passed checks (2 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately summarizes the main change: adding Claude Code skills for common development tasks.
Description check ✅ Passed The description clearly relates to the changeset, detailing motivation, specific changes made, testing approach, and related work.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch silv-io/flc-432

Tip

Try Coding Plans. Let us write the prompt for your AI agent so you can ship faster (with fewer bugs).
Share your feedback on Discord.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🧹 Nitpick comments (1)
.claude/skills/create-pr/SKILL.md (1)

17-25: Use the selected base branch in the example commands too.

The instructions say $ARGUMENTS can override main, but the concrete commands still diff/log against main. That makes the workflow internally inconsistent and can produce the wrong PR context for release or hotfix branches.

Suggested fix
-Run these to understand what's being submitted:
+Resolve the base branch first (`main` by default, or `$ARGUMENTS` when provided), then run:

-git log main..HEAD --oneline
-git diff main...HEAD --stat
-git diff main...HEAD
+git log ..HEAD --oneline
+git diff ...HEAD --stat
+git diff ...HEAD
git branch --show-current

-
-If `$ARGUMENTS` is provided, use it as the base branch instead of `main`.
+If `$ARGUMENTS` is provided, use it as `<base-branch>` instead of `main`.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In @.claude/skills/create-pr/SKILL.md around lines 17 - 25, Update the example
git commands to use the chosen base branch variable instead of hardcoding
"main": replace occurrences of `main` in the `git log main..HEAD --oneline`,
`git diff main...HEAD --stat`, and `git diff main...HEAD` examples so they
reference the selected base branch (e.g., `$ARGUMENTS` or a `<base-branch>`
placeholder) and update the explanatory sentence to say "use `$ARGUMENTS` as
`<base-branch>` instead of `main`" so the examples remain consistent when a
non-main base is provided.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In @.claude/skills/create-pr/SKILL.md:
- Around line 17-22: Add the shell language identifier to both fenced code
blocks containing the git/gh command lists so markdownlint MD040 is satisfied;
specifically update the block that starts with "git log main..HEAD --oneline /
git diff ..." and the block that starts with "git push -u origin HEAD / gh pr
create ..." to use ```shell as the opening fence (leave the closing fence
unchanged).
- Line 6: The allowed-tools list in .claude/skills/create-pr/SKILL.md omits
basic git commands needed by the documented commit flow (git status, git add,
git commit), causing the skill to fail on a dirty branch; update the
allowed-tools entry that currently lists "Bash(git log *), Bash(git diff *),
Bash(git branch *), Bash(git push -u origin HEAD), Bash(gh pr create *),
mcp__plugin_linear_linear__get_issue" to include "Bash(git status *)", "Bash(git
add *)", and "Bash(git commit *)", and make the same addition to the
corresponding allowed-tools block covering lines 75-82 so the skill can stage
and commit changes as described.

---

Nitpick comments:
In @.claude/skills/create-pr/SKILL.md:
- Around line 17-25: Update the example git commands to use the chosen base
branch variable instead of hardcoding "main": replace occurrences of `main` in
the `git log main..HEAD --oneline`, `git diff main...HEAD --stat`, and `git diff
main...HEAD` examples so they reference the selected base branch (e.g.,
`$ARGUMENTS` or a `<base-branch>` placeholder) and update the explanatory
sentence to say "use `$ARGUMENTS` as `<base-branch>` instead of `main`" so the
examples remain consistent when a non-main base is provided.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro

Run ID: e61a10a6-d177-4cab-bb6e-2efadd76c18f

📥 Commits

Reviewing files that changed from the base of the PR and between eb20c46 and a91a8cc.

📒 Files selected for processing (1)
  • .claude/skills/create-pr/SKILL.md

@silv-io silv-io merged commit cd3f6b3 into main Mar 9, 2026
8 checks passed
@silv-io silv-io deleted the silv-io/flc-432 branch March 9, 2026 14:18
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.

2 participants