optimize-agents-md
馃幆Skillfrom plaited/development-skills
Optimizes and refines markdown documentation for AI agent skills, ensuring clarity, consistency, and best practices in skill documentation.
Installation
npx skills add https://github.com/plaited/development-skills --skill optimize-agents-mdSkill Details
Overview
# @plaited/development-skills
[](https://www.npmjs.com/package/@plaited/development-skills)
[](https://github.com/plaited/development-skills/actions/workflows/ci.yml)
[](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
```
Agents: claude 路 cursor 路 copilot 路 codex 路 gemini 路 windsurf 路 opencode 路 amp 路 goose 路 factory
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