Agent SkillsAgent Skills
aiskillstore

blocklet-updater

@aiskillstore/blocklet-updater
aiskillstore
263
23 forks
Updated 5/5/2026
View on GitHub

Creates a new release for a blocklet project by bumping version, building, and bundling. Use when asked to "create a new release", "bump and bundle", or "update blocklet version".

Installation

$npx agent-skills-cli install @aiskillstore/blocklet-updater
Claude Code
Cursor
Copilot
Codex
Antigravity

Details

Pathskills/arcblock/blocklet-updater/SKILL.md
Branchmain
Scoped Name@aiskillstore/blocklet-updater

Usage

After installing, this skill will be available to your AI coding assistant.

Verify installation:

npx agent-skills-cli list

Skill Instructions


name: blocklet-updater description: Creates a new release for a blocklet project by bumping version, building, and bundling. Use when asked to "create a new release", "bump and bundle", or "update blocklet version".

Blocklet Updater

Bumps a blocklet project version and creates a release bundle.

Workflow

1. Version Bump

blocklet version patch

If fails β†’ EXIT with error output.

2. Build System Detection

Check if package.json exists and contains a build script.

If Build Script Exists

Install dependencies and build:

pnpm install && pnpm run build

If either fails β†’ EXIT with error output.

If No Build Script

Skip build step - project is likely pre-built or static.

3. Entry Point Verification

Locate Output Directory & Entry Point

Find index.html in common locations: dist/ β†’ build/ β†’ out/ β†’ public/ β†’ ./

If not found β†’ EXIT with error message: "No index.html entry point found."

Verify blocklet.yml Main Field

Read blocklet.yml and check the main field:

  • If main points to directory containing index.html β†’ valid
  • If main is misaligned β†’ update it to the correct output directory
  • After any update, inform user of the change

4. Metadata Verification

blocklet meta

If fails β†’ EXIT with error output and suggestions.

5. Bundle Creation

blocklet bundle --create-release

If fails β†’ EXIT with error output.

6. Finalization

Do NOT output any summary or recap after completion. Simply end silently after successful bundle creation. The tool outputs already provide sufficient feedback to the user.

Error Reference

See {baseDir}/errors.md for all error conditions and suggestions.

Supporting Files

  • errors.md - Error reference
  • examples.md - Workflow examples

{baseDir} resolves to the skill's installation directory.