lilpacy/agents-md
skills/agents-md/SKILL.md
This skill should be used when the user asks to "create AGENTS.md", "update AGENTS.md", "maintain agent docs", "set up CLAUDE.md", or needs to keep agent instructions concise. Guides discovery of local skills and enforces minimal documentation style.
$ install --global
skillsauthnpx skillsauth add lilpacy/dotfiles agents-mdInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 8, 2026, 6:16 AM268.7s1 file scanned
SKILL.md
- name:
- agents-md
- description:
- This skill should be used when the user asks to "create AGENTS.md", "update AGENTS.md", "maintain agent docs", "set up CLAUDE.md", or needs to keep agent instructions concise. Guides discovery of local skills and enforces minimal documentation style.
Maintaining AGENTS.md
AGENTS.md is the canonical agent-facing documentation. Keep it minimal—agents are capable and don't need hand-holding.
File Setup
- Create
AGENTS.mdat project root - Create symlink:
ln -s AGENTS.md CLAUDE.md
Before Writing
Discover local skills to reference:
find .claude/skills -name "SKILL.md" 2>/dev/null
ls plugins/*/skills/*/SKILL.md 2>/dev/null
Read each skill's frontmatter to understand when to reference it.
Writing Rules
- Headers + bullets - No paragraphs
- Code blocks - For commands and templates
- Reference, don't duplicate - Point to skills: "Use
db-migrateskill. See.claude/skills/db-migrate/SKILL.md" - No filler - No intros, conclusions, or pleasantries
- Trust capabilities - Omit obvious context
- Skill updates - ALWAYS use
/skill-creatorwhen creating or updating skills
Required Sections
Package Manager
Which tool and key commands only:
## Package Manager
Use **pnpm**: `pnpm install`, `pnpm dev`, `pnpm test`
Commit Attribution
Always include this section. Agents should use their own identity:
## Commit Attribution
AI commits MUST include:
Co-Authored-By: (the agent model's name and attribution byline)
Example: `Co-Authored-By: Claude Sonnet 4 <[email protected]>`
Key Conventions
Project-specific patterns agents must follow. Keep brief.
Local Skills
Reference each discovered skill:
## Database
Use `db-migrate` skill for schema changes. See `.claude/skills/db-migrate/SKILL.md`
## Testing
Use `write-tests` skill. See `.claude/skills/write-tests/SKILL.md`
Optional Sections
Add only if truly needed:
- API route patterns (show template, not explanation)
- CLI commands (table format)
- File naming conventions
Anti-Patterns
Omit these:
- "Welcome to..." or "This document explains..."
- "You should..." or "Remember to..."
- Content duplicated from skills (reference instead)
- Obvious instructions ("run tests", "write clean code")
- Explanations of why (just say what)
- Long prose paragraphs
Example Structure
# Agent Instructions
## Package Manager
Use **pnpm**: `pnpm install`, `pnpm dev`
## Commit Attribution
AI commits MUST include:
Co-Authored-By: (the agent model's name and attribution byline)
## API Routes
[Template code block]
## Database
Use `db-migrate` skill. See `.claude/skills/db-migrate/SKILL.md`
## Testing
Use `write-tests` skill. See `.claude/skills/write-tests/SKILL.md`
## CLI
| Command | Description |
|---------|-------------|
| `pnpm cli sync` | Sync data |
Related Skills
lilpacy/web-doc-reading
development
VerifiedTrustedCommunity
Use when searching the web or reading online documentation. Prefer DuckDuckGo for search and read documents through npx curl.md instead of raw HTML.
1SKILL.mdUpdated May 30, 2026
lilpacy/japanese-test-conventions
testing
VerifiedTrustedCommunity
Use when writing or editing tests. Tests should be ordered by near-normal, normal, then abnormal cases where applicable, and test names must be Japanese behavior descriptions from a reviewer/user perspective.
1SKILL.mdUpdated May 30, 2026
lilpacy/gof-functional-patterns
development
VerifiedTrustedCommunity
GoF/オブジェクト指向デザインパターンを関数型プログラミング（pure functions, higher-order functions, ADT, composition, immutability, effect boundaries）でシンプルに整理・設計・リファクタリングする。Strategy/Factory/Adapter/ObserverなどGoF全23パターンのFP置き換え、適用判断、具体事例を提示する必要があるときに使う。
1SKILL.mdUpdated May 30, 2026
lilpacy/git-commit-workflow
tools
VerifiedTrustedCommunity
Use when committing, pushing, or preparing PRs. Defines the user's commit workflow, message style discovery, review handoff, and branch/worktree push requirements.
1SKILL.mdUpdated May 30, 2026