# Build ANcpLua Claude Plugins Correctly

Plugin contributors need consistent structure, validation, and release steps. This skill gives agents repository-specific guidance for safe plugin changes.

## Install

```bash
npx skillstore add ancplua/working-on-ancplua-plugins
```

## Metadata

- - Slug: ancplua-working-on-ancplua-plugins
- - Version: 1.0.0
- - Author: ANcpLua
- - GitHub username: ANcpLua
- - License: MIT
- - Repository: https://github.com/ANcpLua/ancplua-claude-plugins/tree/main/skills/working-on-ancplua-plugins
- - Ref: main
- - Supported tools: Claude, Codex, Claude Code
- - Risk level: medium
- - Risk factors: external\_commands, network, filesystem
- - Quality score: 50
- - Quality tier: warning
- - Public page: https://skillstore.pages.dev/skills/ancplua-working-on-ancplua-plugins
- - Manifest: https://skillstore.pages.dev/api/skills/ancplua-working-on-ancplua-plugins/manifest

## Capabilities

- Explains the ANcpLua plugin directory layout and required manifest locations.
- Shows required plugin metadata fields and marketplace entry expectations.
- Lists validation commands for full checks, marketplace sync, and single-plugin validation.
- Provides debugging checks for JSON syntax, permissions, hardcoded paths, and Claude Code logs.
- Points contributors to official Claude Code plugin, skill, hook, and marketplace documentation.

## Use Cases

- Scaffold a New Plugin: Follow the expected folders, manifest fields, README requirements, and validation checklist for a new repository plugin.
- Debug a Broken Plugin: Check JSON syntax, permissions, hardcoded paths, component behavior, and local Claude Code logs.
- Review a Marketplace Change: Verify version alignment, changelog updates, marketplace sync, and repository conventions before a pull request.

## Prompt Templates

### Plan a Plugin

```
Use this skill to outline the files and validation steps for a new ANcpLua plugin named <plugin-name>.
```

### Check a Change

```
Use this skill to review my changes in plugins/<plugin-name> against repository conventions and required validation steps.
```

### Debug Loading

```
Use this skill to diagnose why plugins/<plugin-name> is not loading. Focus on manifests, paths, permissions, and logs.
```

### Prepare Release Review

```
Use this skill to prepare a release review for plugins/<plugin-name>, including marketplace sync, changelog checks, and remaining risks.
```

## Limitations

- It is documentation only and does not run validators by itself.
- It is specific to the ANcpLua Claude plugin monorepo layout.
- Its command examples require the repository tooling to exist locally.
- It does not replace current upstream Claude Code documentation.

## Best Practices

- Use the repository validation commands after every manifest or marketplace change.
- Keep plugin assets at the plugin root unless the manifest specifically belongs in the manifest directory.
- Replace local absolute paths with portable plugin-root variables before release.

## Anti Patterns

- Do not place skills, commands, or hooks inside the manifest directory.
- Do not hardcode personal filesystem paths in plugin configuration.
- Do not update marketplace metadata without matching plugin version changes.

## Security Audit

- - Safe to publish: true
- - Audited at: 2026-06-28T08:43:47.248\+00:00
- - Summary: Static analysis flagged many high-risk patterns, but review found they are markdown documentation examples rather than executable code. The remaining risk is that the skill asks agents to run local validation, permission, search, and log-inspection commands, so use should stay within a trusted repository.

## Stats

- - Views: 337
- - Downloads: 1
- - Favorites: 0
- - Popularity score: 0