馃幆

optimize-agents-md

馃幆Skill

from plaited/development-skills

VibeIndex|
What it does

Optimizes and refines markdown documentation for AI agent skills, ensuring clarity, consistency, and best practices in skill documentation.

optimize-agents-md

Installation

Install skill:
npx skills add https://github.com/plaited/development-skills --skill optimize-agents-md
2
AddedJan 27, 2026

Skill Details

SKILL.md

Overview

# @plaited/development-skills

[![npm version](https://img.shields.io/npm/v/@plaited/development-skills.svg)](https://www.npmjs.com/package/@plaited/development-skills)

[![CI](https://github.com/plaited/acp-harness/actions/workflows/ci.yml/badge.svg)](https://github.com/plaited/development-skills/actions/workflows/ci.yml)

[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)

> TypeScript LSP tools and AI agent skills for modern development workflows

Examples

```bash

# Find where a type is defined

bunx @plaited/development-skills lsp-find UserConfig

# Get type info at cursor position (line 25, column 10)

bunx @plaited/development-skills lsp-hover src/app.ts 25 10

# Find all usages of a symbol

bunx @plaited/development-skills lsp-refs src/types.ts 15 12

# Validate your AI agent skills

bunx @plaited/development-skills validate-skill .claude/skills

# Scaffold development rules for your project

bunx @plaited/development-skills scaffold-rules

```

Why LSP?

Text search finds strings. LSP finds meaning.

```bash

# Text search: finds "Config" in comments, strings, everywhere

grep -r "Config" src/

# LSP search: finds the actual Config type and its usages

bunx @plaited/development-skills lsp-find Config

```

LSP understands re-exports, aliases, and type relationships.

Install for AI Agents

```bash

curl -fsSL https://raw.githubusercontent.com/plaited/skills-installer/main/install.sh | bash -s -- --agents --project development-skills

```

Agents: claudecursorcopilotcodexgeminiwindsurfopencodeampgoosefactory

Commands

| Command | What it does |

|---------|--------------|

| lsp-hover | Type info at position |

| lsp-find | Symbol search |

| lsp-refs | Find references |

| lsp-analyze | Batch file analysis |

| validate-skill | Validate AgentSkills |

| scaffold-rules | Scaffold dev rules |

Skills Included

  • typescript-lsp - LSP integration for AI agents
  • code-documentation - TSDoc workflow and standards
  • validate-skill - Skill validation
  • scaffold-rules - Development rules scaffolding

License

ISC