agent-linter
Agent ve skill dosyalarinin yapisal dogrulamasi. Frontmatter kontrol, naming convention, zorunlu bolum kontrolu, tutarlilik denetimi. Yeni agent/skill eklendiginde veya mevcut dosyalar duzenlediginde otomatik calistirilir.
Install / Use
npx skills add vibeeval/vibecosystem --skill agent-linterInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of agent-linter
agent-linter scores 83/100 on our quality scale, 3207th of 4,714 Development & Engineering skills we index.
Its SKILL.md is 5.1 KB long, well organised into 19 sections with 5 code examples: a solid amount of guidance for an agent.
It has 535 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 3 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- Our last check on 2026-11-07 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 98/100, with no cautions. These come from repository metadata, not a code audit β read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk β read a skill before letting an agent act on it.
agent-linter compared with similar skills
All 4 of these similar skills score higher than agent-linter; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| agent-linter (this skill)by vibeeval | 83 | 535 | 3mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 117.8k | 9d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.8k | 10d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.9k | today | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.3k | today | CLAUDE.md |
Frequently asked questions
- How do I install agent-linter?
- Run
npx skills add vibeeval/vibecosystem --skill agent-linter. The install tabs above show the steps for each supported agent. - Which AI agents does agent-linter work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is agent-linter safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 98/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is agent-linter still maintained?
- The repository was last updated about 3 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubname: agent-linter description: Agent ve skill dosyalarinin yapisal dogrulamasi. Frontmatter kontrol, naming convention, zorunlu bolum kontrolu, tutarlilik denetimi. Yeni agent/skill eklendiginde veya mevcut dosyalar duzenlediginde otomatik calistirilir.
Agent & Skill Linter
Agent ve skill dosyalarinin kalite kontrolu. Yanlis yapilandirilmis dosyalar runtime'da sessizce basarisiz olur -- linter bunu onler.
Agent Dosyasi Kurallari
Frontmatter (ZORUNLU)
---
name: agent-adi # kebab-case, dosya adiyla AYNI olmali
description: Tek satir # 20-200 karakter arasi
tools: ["Read", "Bash"] # Gecerli tool listesi
model: opus # Opsiyonel: opus | sonnet
---
Frontmatter Validasyonu
| Kural | Kontrol | Hata Seviyesi |
|-------|---------|---------------|
| name mevcut | Frontmatter'da name var mi? | ERROR |
| name = dosya adi | name: sleuth == sleuth.md | ERROR |
| name kebab-case | code-reviewer OK, codeReviewer FAIL | ERROR |
| description mevcut | Bos olmamali | ERROR |
| description uzunlugu | 20-200 karakter | WARN |
| tools array | String array olmali | ERROR |
| tools gecerli | Sadece bilinen tool isimleri | WARN |
| model gecerli | opus, sonnet veya bos | ERROR |
Body Kurallari
| Kural | Kontrol | Hata Seviyesi |
|-------|---------|---------------|
| System prompt var | Frontmatter'dan sonra icerik var | ERROR |
| 50+ satir | Cok kisa agent tanimlari yetersiz | WARN |
| 2000 satir max | Cok uzun dosyalar token israf eder | WARN |
| Markdown basliklar | En az 1 ## basligi var | WARN |
Skill Dosyasi Kurallari
Frontmatter (ZORUNLU)
---
name: skill-adi # kebab-case
description: Aciklama # 20-300 karakter
---
Skill Validasyonu
| Kural | Kontrol | Hata Seviyesi |
|-------|---------|---------------|
| Dosya adi | SKILL.md veya skill.md | ERROR |
| name mevcut | Frontmatter'da | ERROR |
| name = klasor adi | name: tdd-workflow == skills/tdd-workflow/ | WARN |
| description mevcut | Bos olmamali | ERROR |
| Icerik var | Frontmatter'dan sonra en az 20 satir | WARN |
| Kod ornegi var | En az 1 code block | INFO |
Lint Calistirma
Bash Script
#!/bin/bash
# scripts/lint-agents.sh
ERRORS=0
WARNS=0
lint_agent() {
local file="$1"
local name=$(basename "$file" .md)
# Frontmatter kontrolu
if ! head -1 "$file" | grep -q "^---"; then
echo "ERROR: $file - frontmatter yok"
ERRORS=$((ERRORS + 1))
return
fi
# name field kontrolu
local fm_name=$(sed -n '/^---$/,/^---$/p' "$file" | grep "^name:" | sed 's/name: *//')
if [ -z "$fm_name" ]; then
echo "ERROR: $file - name field yok"
ERRORS=$((ERRORS + 1))
elif [ "$fm_name" != "$name" ]; then
echo "ERROR: $file - name '$fm_name' != dosya adi '$name'"
ERRORS=$((ERRORS + 1))
fi
# description kontrolu
local desc=$(sed -n '/^---$/,/^---$/p' "$file" | grep "^description:")
if [ -z "$desc" ]; then
echo "ERROR: $file - description yok"
ERRORS=$((ERRORS + 1))
fi
# Uzunluk kontrolu
local lines=$(wc -l < "$file")
if [ "$lines" -lt 10 ]; then
echo "WARN: $file - cok kisa ($lines satir)"
WARNS=$((WARNS + 1))
elif [ "$lines" -gt 2000 ]; then
echo "WARN: $file - cok uzun ($lines satir)"
WARNS=$((WARNS + 1))
fi
}
echo "=== Agent Linter ==="
for f in agents/*.md; do
lint_agent "$f"
done
echo ""
echo "=== Skill Linter ==="
for f in skills/*/SKILL.md skills/*/skill.md; do
[ -f "$f" ] && lint_agent "$f"
done
echo ""
echo "Sonuc: $ERRORS error, $WARNS warning"
[ "$ERRORS" -gt 0 ] && exit 1 || exit 0
CI Entegrasyonu
# .github/workflows/lint-agents.yml
name: Agent & Skill Lint
on:
pull_request:
paths: ['agents/**', 'skills/**']
jobs:
lint:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: bash scripts/lint-agents.sh
Yaygin Hatalar
| Hata | Ornek | Cozum |
|------|-------|-------|
| name/dosya uyumsuzlugu | name: codeReviewer dosya: code-reviewer.md | name'i kebab-case yap |
| Description cok kisa | description: Reviews code | Ne yaptigini detayla |
| Tools yanlis format | tools: Read, Bash | tools: ["Read", "Bash"] |
| Bos agent dosyasi | Sadece frontmatter, body yok | System prompt ekle |
| Duplicate name | 2 agent ayni name'e sahip | Benzersiz isim ver |
| Skill klasor/name uyumsuz | name: tdd klasor: tdd-workflow/ | Eslestir |
Toplu Lint Raporu
# Tum agent'lari tara, rapor uret
cd ~/vibecosystem
bash scripts/lint-agents.sh 2>&1 | tee lint-report.txt
# Sadece ERROR'lari goster
grep "^ERROR" lint-report.txt
# Istatistik
echo "Agents: $(ls agents/*.md | wc -l)"
echo "Skills: $(ls skills/*/SKILL.md skills/*/skill.md 2>/dev/null | wc -l)"
echo "Errors: $(grep -c ERROR lint-report.txt)"
echo "Warnings: $(grep -c WARN lint-report.txt)"
vibecosystem Entegrasyonu
- verifier agent: Lint'i final quality gate'e ekle
- qa-engineer agent: Yeni agent/skill PR'larinda lint calistir
- self-learner agent: Lint hatalari pattern olarak ogren
- catalyst agent: Scaffold sΔ±rasinda lint-uyumlu dosya uret
- /commit skill: Commit oncesi agent/skill dosyalarini lint'le
Related Skills
taste-skill
117.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.8kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu β one CLI, zero API fees.
headroom
79.9kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
ai-job-search
72.3kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit β see the Safety scan above for what the skill file itself contains.
