agent-linter

Name: agent-linter
Author: vibeeval

519stars44forks

How to install agent-linter?

vibeeval/vibecosystem/agent-linter

$npx -y skills add vibeeval/vibecosystem --skill agent-linter

Installs into the current project.

Summary

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.

Files · 1

View on GitHub

SKILL.md

1	# Agent & Skill Linter
2
3	Agent ve skill dosyalarinin kalite kontrolu. Yanlis yapilandirilmis dosyalar runtime'da sessizce basarisiz olur -- linter bunu onler.
4
5	## Agent Dosyasi Kurallari
6
7	### Frontmatter (ZORUNLU)
8
9	```yaml
10	---
11	name: agent-adi # kebab-case, dosya adiyla AYNI olmali
12	description: Tek satir # 20-200 karakter arasi
13	tools: ["Read", "Bash"] # Gecerli tool listesi
14	model: opus # Opsiyonel: opus \| sonnet
15	---
16	```
17
18	### Frontmatter Validasyonu
19
20	\| Kural \| Kontrol \| Hata Seviyesi \|
21	\|-------\|---------\|---------------\|
22	\| `name` mevcut \| Frontmatter'da name var mi? \| ERROR \|
23	\| `name` = dosya adi \| `name: sleuth` == `sleuth.md` \| ERROR \|
24	\| `name` kebab-case \| `code-reviewer` OK, `codeReviewer` FAIL \| ERROR \|
25	\| `description` mevcut \| Bos olmamali \| ERROR \|
26	\| `description` uzunlugu \| 20-200 karakter \| WARN \|
27	\| `tools` array \| String array olmali \| ERROR \|
28	\| `tools` gecerli \| Sadece bilinen tool isimleri \| WARN \|
29	\| `model` gecerli \| opus, sonnet veya bos \| ERROR \|
30
31	### Body Kurallari
32
33	\| Kural \| Kontrol \| Hata Seviyesi \|
34	\|-------\|---------\|---------------\|
35	\| System prompt var \| Frontmatter'dan sonra icerik var \| ERROR \|
36	\| 50+ satir \| Cok kisa agent tanimlari yetersiz \| WARN \|
37	\| 2000 satir max \| Cok uzun dosyalar token israf eder \| WARN \|
38	\| Markdown basliklar \| En az 1 `##` basligi var \| WARN \|
39
40	## Skill Dosyasi Kurallari
41
42	### Frontmatter (ZORUNLU)
43
44	```yaml
45	---
46	name: skill-adi # kebab-case
47	description: Aciklama # 20-300 karakter
48	---
49	```
50
51	### Skill Validasyonu
52
53	\| Kural \| Kontrol \| Hata Seviyesi \|
54	\|-------\|---------\|---------------\|
55	\| Dosya adi \| `SKILL.md` veya `skill.md` \| ERROR \|
56	\| `name` mevcut \| Frontmatter'da \| ERROR \|
57	\| `name` = klasor adi \| `name: tdd-workflow` == `skills/tdd-workflow/` \| WARN \|
58	\| `description` mevcut \| Bos olmamali \| ERROR \|
59	\| Icerik var \| Frontmatter'dan sonra en az 20 satir \| WARN \|
60	\| Kod ornegi var \| En az 1 code block \| INFO \|
61
62	## Lint Calistirma
63
64	### Bash Script
65
66	```bash
67	#!/bin/bash
68	# scripts/lint-agents.sh
69
70	ERRORS=0
71	WARNS=0
72
73	lint_agent() {
74	local file="$1"
75	local name=$(basename "$file" .md)
76
77	# Frontmatter kontrolu
78	if ! head -1 "$file" \| grep -q "^---"; then
79	echo "ERROR: $file - frontmatter yok"
80	ERRORS=$((ERRORS + 1))
81	return
82	fi
83
84	# name field kontrolu
85	local fm_name=$(sed -n '/^---$/,/^---$/p' "$file" \| grep "^name:" \| sed 's/name: *//')
86	if [ -z "$fm_name" ]; then
87	echo "ERROR: $file - name field yok"
88	ERRORS=$((ERRORS + 1))
89	elif [ "$fm_name" != "$name" ]; then
90	echo "ERROR: $file - name '$fm_name' != dosya adi '$name'"
91	ERRORS=$((ERRORS + 1))
92	fi
93
94	# description kontrolu
95	local desc=$(sed -n '/^---$/,/^---$/p' "$file" \| grep "^description:")
96	if [ -z "$desc" ]; then
97	echo "ERROR: $file - description yok"
98	ERRORS=$((ERRORS + 1))
99	fi
100
101	# Uzunluk kontrolu
102	local lines=$(wc -l < "$file")
103	if [ "$lines" -lt 10 ]; then
104	echo "WARN: $file - cok kisa ($lines satir)"
105	WARNS=$((WARNS + 1))
106	elif [ "$lines" -gt 2000 ]; then
107	echo "WARN: $file - cok uzun ($lines satir)"
108	WARNS=$((WARNS + 1))
109	fi
110	}
111
112	echo "=== Agent Linter ==="
113	for f in agents/*.md; do
114	lint_agent "$f"
115	done
116
117	echo ""
118	echo "=== Skill Linter ==="
119	for f in skills//SKILL.md skills//skill.md; do
120	[ -f "$f" ] && lint_agent "$f"
121	done
122
123	echo ""
124	echo "Sonuc: $ERRORS error, $WARNS warning"
125	[ "$ERRORS" -gt 0 ] && exit 1 \|\| exit 0
126	```
127
128	### CI Entegrasyonu
129
130	```yaml
131	# .github/workflows/lint-agents.yml
132	name: Agent & Skill Lint
133	on:
134	pull_request:
135	paths: ['agents/', 'skills/']
136
137	jobs:
138	lint:
139	runs-on: ubuntu-latest
140	steps:
141	- uses: actions/checkout@v4
142	- run: bash scripts/lint-agents.sh
143	```
144
145	## Yaygin Hatalar
146
147	\| Hata \| Ornek \| Cozum \|
148	\|------\|-------\|-------\|
149	\| name/dosya uyumsuzlugu \| `name: codeReviewer` dosya: `code-reviewer.md` \| name'i kebab-case yap \|
150	\| Description cok kisa \| `description: Reviews code` \| Ne yaptigini detayla \|
151	\| Tools yanlis format \| `tools: Read, Bash` \| `tools: ["Read", "Bash"]` \|
152	\| Bos agent dosyasi \| Sadece frontmatter, body yok \| System prompt ekle \|
153	\| Duplicate name \| 2 agent ayni name'e sahip \| Benzersiz isim ver \|
154	\| Skill klasor/name uyumsuz \| `name: tdd` klasor: `tdd-workflow/` \| Eslestir \|
155
156	## Toplu Lint Raporu
157
158	```bash
159	# Tum agent'lari tara, rapor uret
160	cd ~/vibecosystem
161	bash scripts/lint-agents.sh 2>&1 \| tee lint-report.txt
162
163	# Sadece ERROR'lari goster
164	grep "^ERROR" lint-report.txt
165
166	# Istatistik
167	echo "Agents: $(ls agents/*.md \| wc -l)"
168	echo "Skills: $(ls skills//SKILL.md skills//skill.md 2>/dev/null \| wc -l)"
169	echo "Errors: $(grep -c ERROR lint-report.txt)"
170	echo "Warnings: $(grep -c WARN lint-report.txt)"
171	```
172
173	## vibecosystem Entegrasyonu
174
175	- verifier agent: Lint'i final quality gate'e ekle
176	- qa-engineer agent: Yeni agen

People who liked this also viewed

6 picks

Type

agent-linter

519stars44forks

View on GitHub

How to install agent-linter?

vibeeval/vibecosystem/agent-linter

$npx -y skills add vibeeval/vibecosystem --skill agent-linter

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Agent & Skill Linter
2
3	Agent ve skill dosyalarinin kalite kontrolu. Yanlis yapilandirilmis dosyalar runtime'da sessizce basarisiz olur -- linter bunu onler.
4
5	## Agent Dosyasi Kurallari
6
7	### Frontmatter (ZORUNLU)
8
9	```yaml
10	---
11	name: agent-adi # kebab-case, dosya adiyla AYNI olmali
12	description: Tek satir # 20-200 karakter arasi
13	tools: ["Read", "Bash"] # Gecerli tool listesi
14	model: opus # Opsiyonel: opus \| sonnet
15	---
16	```
17
18	### Frontmatter Validasyonu
19
20	\| Kural \| Kontrol \| Hata Seviyesi \|
21	\|-------\|---------\|---------------\|
22	\| `name` mevcut \| Frontmatter'da name var mi? \| ERROR \|
23	\| `name` = dosya adi \| `name: sleuth` == `sleuth.md` \| ERROR \|
24	\| `name` kebab-case \| `code-reviewer` OK, `codeReviewer` FAIL \| ERROR \|
25	\| `description` mevcut \| Bos olmamali \| ERROR \|
26	\| `description` uzunlugu \| 20-200 karakter \| WARN \|
27	\| `tools` array \| String array olmali \| ERROR \|
28	\| `tools` gecerli \| Sadece bilinen tool isimleri \| WARN \|
29	\| `model` gecerli \| opus, sonnet veya bos \| ERROR \|
30
31	### Body Kurallari
32
33	\| Kural \| Kontrol \| Hata Seviyesi \|
34	\|-------\|---------\|---------------\|
35	\| System prompt var \| Frontmatter'dan sonra icerik var \| ERROR \|
36	\| 50+ satir \| Cok kisa agent tanimlari yetersiz \| WARN \|
37	\| 2000 satir max \| Cok uzun dosyalar token israf eder \| WARN \|
38	\| Markdown basliklar \| En az 1 `##` basligi var \| WARN \|
39
40	## Skill Dosyasi Kurallari
41
42	### Frontmatter (ZORUNLU)
43
44	```yaml
45	---
46	name: skill-adi # kebab-case
47	description: Aciklama # 20-300 karakter
48	---
49	```
50
51	### Skill Validasyonu
52
53	\| Kural \| Kontrol \| Hata Seviyesi \|
54	\|-------\|---------\|---------------\|
55	\| Dosya adi \| `SKILL.md` veya `skill.md` \| ERROR \|
56	\| `name` mevcut \| Frontmatter'da \| ERROR \|
57	\| `name` = klasor adi \| `name: tdd-workflow` == `skills/tdd-workflow/` \| WARN \|
58	\| `description` mevcut \| Bos olmamali \| ERROR \|
59	\| Icerik var \| Frontmatter'dan sonra en az 20 satir \| WARN \|
60	\| Kod ornegi var \| En az 1 code block \| INFO \|
61
62	## Lint Calistirma
63
64	### Bash Script
65
66	```bash
67	#!/bin/bash
68	# scripts/lint-agents.sh
69
70	ERRORS=0
71	WARNS=0
72
73	lint_agent() {
74	local file="$1"
75	local name=$(basename "$file" .md)
76
77	# Frontmatter kontrolu
78	if ! head -1 "$file" \| grep -q "^---"; then
79	echo "ERROR: $file - frontmatter yok"
80	ERRORS=$((ERRORS + 1))
81	return
82	fi
83
84	# name field kontrolu
85	local fm_name=$(sed -n '/^---$/,/^---$/p' "$file" \| grep "^name:" \| sed 's/name: *//')
86	if [ -z "$fm_name" ]; then
87	echo "ERROR: $file - name field yok"
88	ERRORS=$((ERRORS + 1))
89	elif [ "$fm_name" != "$name" ]; then
90	echo "ERROR: $file - name '$fm_name' != dosya adi '$name'"
91	ERRORS=$((ERRORS + 1))
92	fi
93
94	# description kontrolu
95	local desc=$(sed -n '/^---$/,/^---$/p' "$file" \| grep "^description:")
96	if [ -z "$desc" ]; then
97	echo "ERROR: $file - description yok"
98	ERRORS=$((ERRORS + 1))
99	fi
100
101	# Uzunluk kontrolu
102	local lines=$(wc -l < "$file")
103	if [ "$lines" -lt 10 ]; then
104	echo "WARN: $file - cok kisa ($lines satir)"
105	WARNS=$((WARNS + 1))
106	elif [ "$lines" -gt 2000 ]; then
107	echo "WARN: $file - cok uzun ($lines satir)"
108	WARNS=$((WARNS + 1))
109	fi
110	}
111
112	echo "=== Agent Linter ==="
113	for f in agents/*.md; do
114	lint_agent "$f"
115	done
116
117	echo ""
118	echo "=== Skill Linter ==="
119	for f in skills//SKILL.md skills//skill.md; do
120	[ -f "$f" ] && lint_agent "$f"
121	done
122
123	echo ""
124	echo "Sonuc: $ERRORS error, $WARNS warning"
125	[ "$ERRORS" -gt 0 ] && exit 1 \|\| exit 0
126	```
127
128	### CI Entegrasyonu
129
130	```yaml
131	# .github/workflows/lint-agents.yml
132	name: Agent & Skill Lint
133	on:
134	pull_request:
135	paths: ['agents/', 'skills/']
136
137	jobs:
138	lint:
139	runs-on: ubuntu-latest
140	steps:
141	- uses: actions/checkout@v4
142	- run: bash scripts/lint-agents.sh
143	```
144
145	## Yaygin Hatalar
146
147	\| Hata \| Ornek \| Cozum \|
148	\|------\|-------\|-------\|
149	\| name/dosya uyumsuzlugu \| `name: codeReviewer` dosya: `code-reviewer.md` \| name'i kebab-case yap \|
150	\| Description cok kisa \| `description: Reviews code` \| Ne yaptigini detayla \|
151	\| Tools yanlis format \| `tools: Read, Bash` \| `tools: ["Read", "Bash"]` \|
152	\| Bos agent dosyasi \| Sadece frontmatter, body yok \| System prompt ekle \|
153	\| Duplicate name \| 2 agent ayni name'e sahip \| Benzersiz isim ver \|
154	\| Skill klasor/name uyumsuz \| `name: tdd` klasor: `tdd-workflow/` \| Eslestir \|
155
156	## Toplu Lint Raporu
157
158	```bash
159	# Tum agent'lari tara, rapor uret
160	cd ~/vibecosystem
161	bash scripts/lint-agents.sh 2>&1 \| tee lint-report.txt
162
163	# Sadece ERROR'lari goster
164	grep "^ERROR" lint-report.txt
165
166	# Istatistik
167	echo "Agents: $(ls agents/*.md \| wc -l)"
168	echo "Skills: $(ls skills//SKILL.md skills//skill.md 2>/dev/null \| wc -l)"
169	echo "Errors: $(grep -c ERROR lint-report.txt)"
170	echo "Warnings: $(grep -c WARN lint-report.txt)"
171	```
172
173	## vibecosystem Entegrasyonu
174
175	- verifier agent: Lint'i final quality gate'e ekle
176	- qa-engineer agent: Yeni agen

People who liked this also viewed

6 picks

Type