# Convert Web Projects to Blocklets

Preparing a web project for ArcBlock deployment requires correct metadata, assets, and bundle settings. This skill guides Claude, Codex, or Claude Code through conversion and validation steps.

## Install

```bash
npx skillstore add arcblock/blocklet-converter
```

## Metadata

- Status: approved
- Slug: arcblock-blocklet-converter
- Skillstore revision: r1
- Version status: missing
- Tree hash: c2a558834a6550e20594127ceccad1faa079209d2fef28c1ddba9699e756d163
- Author: ArcBlock
- GitHub username: ArcBlock
- License: MIT
- Repository: https://github.com/ArcBlock/agent-skills/tree/main/plugins/blocklet/skills/blocklet-converter
- Ref: 7db9b9f06e0ab79c575b58bc48c4d8dc9849f424
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: confirmation\_required
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: env\_access, external\_commands, network
- Quality score: 50
- Quality tier: warning
- Public page: https://skillstore.pages.dev/skills/arcblock-blocklet-converter
- Manifest: https://skillstore.pages.dev/api/skills/arcblock-blocklet-converter/manifest

## Capabilities

- Detects whether a project is a static web app or a Next.js app.
- Requires and validates a provided Blocklet DID before conversion.
- Extracts title and description metadata from package.json.
- Generates or copies required Blocklet files such as README, logo, and blocklet.yml.
- Runs build and Blocklet validation commands when the workflow reaches verification.
- Reports defined error conditions and stops when conversion prerequisites are missing.

## Use Cases

- Package a React site for ArcBlock: Convert a Vite or React static site into a Blocklet with generated metadata and deployment files.
- Prepare a Next.js project for Blocklet bundling: Add the required Blocklet entry point and configuration for a production Next.js application.
- Validate deployment readiness: Check that build outputs, assets, and Blocklet metadata are present before creating a release bundle.

## Prompt Templates

### Convert a simple web app

```
Convert this project to an ArcBlock blocklet using DID z8iaExampleDidValue. Stop if the project is not a supported web app.
```

### Convert and explain required changes

```
Review this project for Blocklet conversion using DID z8iaExampleDidValue. Tell me what files you will create or update before running commands.
```

### Prepare a Next.js Blocklet

```
Convert this Next.js project into a Blocklet with DID z8iaExampleDidValue. Verify the production entry point and blocklet.yml settings.
```

### Audit conversion readiness

```
Check this project for Blocklet readiness using DID z8iaExampleDidValue. Validate metadata, output paths, assets, and bundle commands before creating a release.
```

## Limitations

- Only supports static web applications and Next.js projects.
- Requires a pre-generated Blocklet DID from the user.
- May run dependency installation and build commands in the local project.
- Does not support backend frameworks such as Express, Koa, Fastify, or Nest.

## Best Practices

- Review the target project before allowing dependency installation or build commands.
- Generate the Blocklet DID before starting the conversion workflow.
- Confirm the detected output directory before creating the final bundle.

## Anti Patterns

- Do not run the conversion in an untrusted repository without reviewing scripts first.
- Do not use this skill for backend services or API-only projects.
- Do not continue after build, metadata, or bundle validation errors.

## Security Audit

- Audited at: 2026-07-09T01:01:37.997\+00:00
- Summary: Most static findings are false positives caused by Markdown backticks, documented Blocklet runtime environment variables, and normal deployment metadata. The confirmed risk is intended external command execution: the skill installs dependencies, runs build commands, and invokes the Blocklet CLI in the target project.

## Stats

- Views: 304
- Downloads: 9
- Favorites: 0
- Popularity score: 0