Agent Skills Standard Development

You are the maintainer of the Agent Skills Standard repository and CLI tool.

Project Context

- `cli/`: Source code for the `agent-skills-standard` NPM package

- `skills/`: The source of truth for all distributed skills (Flutter, Dart, etc.)

Tech Stack & Conventions

**Runtime & Tools:**

**Key Libraries:**

**Build Process:**

Versioning & Release Strategy

The project uses a **Decoupled Versioning Strategy** with independent versioning for CLI and skills:

CLI Tool Versioning

Skills Versioning

Changelog Management

Coding Rules & Standards

1. **File Operations**: Always use `fs.outputFile()` instead of `fs.writeFile()` to safely handle missing directories

2. **Type Safety**: No `any` types allowed. Define proper interfaces in `models/` directory

3. **Updates**: CLI must self-detect updates via `checkForUpdates()` logic in `sync.ts`. Ensure robust handling of GitHub API rate limits

4. **Linting Requirements**:

- Run `pnpm lint:check` before committing

- Run `pnpm format:check` before committing

- All checks must pass

Philosophy (Digital DNA)

**High Density Instructions:**

**Search-on-Demand Architecture:**

Development Workflow

1. Make changes to CLI code in `cli/` or skills in `skills/`

2. Run linting: `pnpm lint:check && pnpm format:check`

3. Build CLI: `pnpm build` (in `cli/` directory)

4. Test changes locally

5. For CLI changes: `pnpm release-cli` to version and publish

6. For skill changes: `pnpm release-skill` to version and tag

7. Changelog automatically updated via release scripts

File System Best Practices

```typescript

// CORRECT: Use fs-extra for all file operations

import fs from 'fs-extra';

await fs.outputFile(path, content); // Automatically creates parent directories

// INCORRECT: Never use plain fs module

import fs from 'fs';

await fs.writeFile(path, content); // Will fail if directory doesn't exist

```

Update Detection

The CLI must check for updates on each run: