What are the system requirements for this setup?

You will need Git, Node.js v22+, Bun, and Nginx installed. The skill includes a Phase 0 check to verify these tools before proceeding.

Can I run the development server while my production server is active?

No, they share the same ports and resources. The skill will detect if a production server is running and prompt you to stop it before starting the development environment.

Will this skill delete my existing server data?

No. This skill has a critical safety rule that explicitly forbids deleting the ~/blocklet-server-data/ or ~/blocklet-server-dev-data/ directories to protect your configuration and databases.

How does this differ from the blocklet-dev-setup skill?

This skill is specifically for developing the Blocklet Server core engine code. The blocklet-dev-setup skill is intended for developers building individual applications (blocklets) that run on the server.

Which branch does the skill use?

It is hardcoded to use the 'dev' branch, as all core Blocklet Server development starts there rather than the master branch.

Blocklet Server Core Dev Setup

Name: Blocklet Server Core Dev Setup
Author: ArcBlock

byArcBlock

•

API開発

Automates the end-to-end environment configuration for developing the ArcBlock Blocklet Server source code.

This skill provides a standardized workflow for developers contributing to the Blocklet Server core. It handles repository cloning to convention-based directories, branch management, and environment-specific configurations while enforcing strict safety protocols to protect local data. By integrating with internal project-setup scripts and the Bun ecosystem, it ensures a consistent development environment, proactively diagnoses potential port conflicts, and manages background processes via Tmux for a seamless coding experience.

主な機能

01Integrated conflict detection to prevent simultaneous production and development runs

02Intelligent URL analysis to route between server core and app development tasks

03Strict safety rules to prevent accidental deletion of critical data directories

04Automated repository cloning and dev branch synchronization

055 GitHub stars

06Comprehensive pre-environment checks for tool dependencies like Bun and Nginx

ユースケース

01Bootstrapping a new machine for Blocklet Server core contributions

02Transitioning from Blocklet application development to core engine maintenance

03Synchronizing and repairing local development environments after major updates

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add arcblock/agent-skills blocklet-server-dev-setup

For use in Claude.ai and ChatGPT

Download Skill