open-index/open-npm huggingface dataset:
npm package: @skillscraft/cli
Description: CLI for building, validating, and linting Agent Skills
Latest version: 0.9.1

# @skillscraft/cli

CLI for building, validating, and linting Agent Skills against the Agent Skills specification.

## Installation

```bash
npm install -g @skillscraft/cli
```

This provides the `skill` command.

## Commands

### `skill init <name>`

Scaffold a new Agent Skill directory with a SKILL.md template.

```bash
skill init my-new-skill
skill init my-new-skill --template basic
```

**Options:**
- `-t, --template <template>` -- template to use (default: `basic`)

### `skill validate <path>`

Validate a skill against the Agent Skills specification.

```bash
skill validate ./my-skill/SKILL.md
skill validate ./my-skill/SKILL.md --strict
```

**Options:**
- `-s, --strict` -- treat warnings as errors

### `skill lint <path>`

Lint a skill for best practices.

```bash
skill lint ./my-skill/SKILL.md
skill lint ./my-skill/SKILL.md --fix
```

**Options:**
- `--fix` -- show fix suggestions

### `skill install <path>`

Install a skill for a specific agent or generically.

```bash
skill install ./my-skill
skill install ./my-skill --target claude --scope project
skill install ./my-skill --target copilot --scope user --force
```

**Options:**
- `-t, --target <target>` -- target agent: `claude`, `copilot`, `codex`, `generic` (default: `generic`)
- `-s, --scope <scope>` -- install scope: `project` or `user` (default: `project`)
- `-f, --force` -- overwrite existing installation

## License

Apache-2.0

## Links

- [Main repository](https://github.com/Pratiyush/agentic-skills-framework)
- [Documentation](https://pratiyush.github.io/agentic-skills-framework)
- [Marketplace](https://github.com/Pratiyush/skillscraft-hub)
npm package: @skillscraft/core
Description: Parse, validate, and lint Agent Skills
Latest version: 0.9.1

# @skillscraft/core

Parse, validate, and lint Agent Skills against the Agent Skills specification.

## Installation

```bash
npm install @skillscraft/core
```

## What it exports

- `parseSkill(filePath)` -- parse a SKILL.md file into a `ParsedSkill` object (frontmatter + body)
- `validateSkill(skill)` -- validate a parsed skill against the specification, returning errors and warnings
- `lintSkill(skill)` -- lint a parsed skill for best practices (description quality, body length, naming)
- `loadSkillManifest(dirPath)` -- load a full skill manifest from a directory (skill + files + directory flags)
- `LINT_RULES` -- the set of built-in lint rules

All types from `@skillscraft/spec` are re-exported for convenience.

## Usage

### Parse a skill

```typescript
import { parseSkill } from "@skillscraft/core";

const skill = await parseSkill("/path/to/my-skill/SKILL.md");
console.log(skill.frontmatter.name); // "my-skill"
console.log(skill.body); // markdown body content
```

### Validate a skill

```typescript
import { parseSkill, validateSkill } from "@skillscraft/core";

const skill = await parseSkill("/path/to/my-skill/SKILL.md");
const result = validateSkill(skill);

if (result.valid) {
  console.log("Skill is valid.");
} else {
  result.errors.forEach((e) => console.error(e.message));
}
```

### Lint a skill

```typescript
import { parseSkill, lintSkill } from "@skillscraft/core";

const skill = await parseSkill("/path/to/my-skill/SKILL.md");
const result = lintSkill(skill);

result.diagnostics.forEach((d) =>
  console.log(`[${d.severity}] ${d.message}`)
);
```

## License

Apache-2.0

## Links

- [Main repository](https://github.com/Pratiyush/agentic-skills-framework)
- [Documentation](https://pratiyush.github.io/agentic-skills-framework)
npm package: @skillscraft/spec
Description: TypeScript types and JSON schemas for the Agent Skills specification
Latest version: 0.9.1

# @skillscraft/spec

TypeScript types, constants, and JSON schemas for the Agent Skills specification.

## Installation

```bash
npm install @skillscraft/spec
```

## What it exports

**Core types** -- mirror the Agent Skills specification exactly:

- `SkillFrontmatter` -- YAML frontmatter fields (name, description, license, compatibility, metadata, allowed-tools)
- `ParsedSkill` -- full parsed SKILL.md (frontmatter + body + file paths)
- `SkillManifest` -- complete skill package (parsed skill + file listing + directory flags)
- `SkillFile`, `SkillMetadata`

**Extended types** -- optional enterprise-grade additions (security, testing, tool-binding, composition):

- `SecurityManifest`, `CapabilityDeclaration`
- `TestScenario`, `TestCase`, `TestAssertion`
- `ToolBinding`, `ToolDependency`
- `SkillComposition`, `SkillDependency`

**Result types** -- for validation and linting outputs:

- `ValidationResult`, `ValidationError`, `ValidationSeverity`
- `LintResult`, `LintDiagnostic`, `LintRule`, `LintSeverity`

**Constants:**

- `SPEC_LIMITS` -- field length limits from the specification (name, description, compatibility, body)
- `SKILL_NAME_REGEX` -- regex for valid skill names (lowercase alphanumeric + hyphens, 1-64 chars)

## Usage

```typescript
import type { SkillFrontmatter, ParsedSkill } from "@skillscraft/spec";
import { SPEC_LIMITS, SKILL_NAME_REGEX } from "@skillscraft/spec";

const frontmatter: SkillFrontmatter = {
  name: "my-skill",
  description: "A skill that does something useful.",
};

console.log(SPEC_LIMITS.NAME_MAX_LENGTH); // 64
console.log(SKILL_NAME_REGEX.test("my-skill")); // true
```

## License

Apache-2.0

## Links

- [Main repository](https://github.com/Pratiyush/agentic-skills-framework)
- [Documentation](https://pratiyush.github.io/agentic-skills-framework)