Skip to content

refactor: Move publishing docs to /release skill (CYPACK-667)#705

Merged
Connoropolous merged 7 commits intomainfrom
cypack-667
Dec 28, 2025
Merged

refactor: Move publishing docs to /release skill (CYPACK-667)#705
Connoropolous merged 7 commits intomainfrom
cypack-667

Conversation

@cyrusagent
Copy link
Copy Markdown
Contributor

Summary

  • Moved the publishing workflow documentation from CLAUDE.md to a dedicated /release skill
  • Created .claude/skills/release/SKILL.md with the complete publishing workflow
  • Replaced the verbose CLAUDE.md section with a concise reference to the skill

Changes

  • New file: .claude/skills/release/SKILL.md - Contains the full publishing workflow including:

    • Pre-publishing checklist (changelog updates, Linear issue review)
    • Step-by-step publishing commands in dependency order
    • Post-release Linear issue status updates
    • Key notes and best practices
  • Modified: CLAUDE.md - Replaced ~75 lines of publishing docs with a 5-line skill reference

Benefits

  • Cleaner CLAUDE.md file (reduced cognitive load)
  • Publishing workflow is now invokable via /release skill
  • Skill format allows for better tool permissions configuration

Test Plan

  • Verified skill file is properly formatted with frontmatter
  • Verified CLAUDE.md references the skill correctly
  • Skill directory structure follows existing convention (.claude/skills/release/)

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 4.5 noreply@anthropic.com

- Create new .claude/skills/release/SKILL.md with complete publishing workflow
- Replace verbose CLAUDE.md publishing section with skill reference
- Skill includes pre-publishing checklist, dependency order, and Linear issue updates
…l (CYPACK-667)

- Move CYPACK-547 entry to [0.2.6] section (was already released)
- Update release skill to mention updating both CHANGELOG.md and CHANGELOG.internal.md
Comment thread .claude/skills/release/SKILL.md Outdated
---
name: release
description: Run a Cyrus release by publishing all packages to npm in the correct dependency order, updating changelogs, and creating git tags.
allowed-tools: Bash, Read, Edit, Write, Glob, Grep, mcp__linear__update_issue, mcp__linear__list_issues
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

remove the allowed-tools list, claude-agent-sdk doesn't respect it anyway

Comment thread CLAUDE.md Outdated
## Publishing

**Important: Always publish packages in the correct order to ensure proper dependency resolution.**
For publishing and release instructions, use the `/release` skill which provides a complete guide for publishing packages to npm in the correct dependency order. Invoke it with:
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Make sure to note this means 'within Claude Code' or Claude Agent SDK (the / command)

- Remove allowed-tools from skill frontmatter (not respected by SDK)
- Clarify that /release is invoked within Claude Code or Claude Agent SDK
- Remove obsolete ndjson-client package
- Add missing packages: cloudflare-tunnel-client, config-updater, linear-event-transport, gemini-runner
- Update dependency order to match current package structure
- Add step 6 for creating GitHub release with changelog notes
- Renumber 'Update Linear Issues' to step 7
- Update all package versions to 0.2.7
- Update CHANGELOG.md with v0.2.7 release notes
- Update CHANGELOG.internal.md with v0.2.7 section
@Connoropolous Connoropolous merged commit 09e8472 into main Dec 28, 2025
6 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.

2 participants