Repository navigation
Expand file tree
/
Copy pathMakefile
More file actions
156 lines (140 loc) · 7.33 KB
/
Copy pathMakefile
File metadata and controls
156 lines (140 loc) · 7.33 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
.PHONY: help install validate validate-structure validate-collection-schema validate-collection-compliance validate-compass-manifests validate-lifecycle-ceiling validate-skill-design validate-skill-design-changed validate-mcp-tools validate-spelling validate-scripts package clean check-uv
help:
@echo "agentic-plugins"
@echo ""
@echo "Available targets:"
@echo " install - Install Python dependencies (requires uv)"
@echo " validate - Full validation: Tier 1 (agentskills.io) + Tier 2 (structure, compliance, design)"
@echo " validate-structure - Structure, links, compliance, MCP tools (no per-skill tier checks)"
@echo " validate-collection-schema - Schema + roster + banners (subset of compliance)"
@echo " validate-collection-compliance - Full .catalog compliance (includes collection.json drift)"
@echo " validate-compass-manifests - Compass manifests, roster, refs, and skill references/ layout"
@echo " validate-lifecycle-ceiling - Compass lifecycle ceiling (skill <= plugin lifecycle) + unit tests"
@echo " validate-skill-design - Validate all skills (use PLUGIN=rh-sre for a specific plugin)"
@echo " validate-skill-design-changed - Validate only changed skills (staged + unstaged, for local dev)"
@echo " validate-mcp-tools - Validate allowed-tools against live MCP servers (requires podman)"
@echo " validate-spelling - Run codespell spell check on all files"
@echo " validate-scripts - Run ruff lint on skill scripts (<plugin>/skills/*/scripts/*.py)"
@echo " package - Package skills into ZIPs (output: dist/)"
@echo " clean - Remove generated files"
@echo ""
@echo "Requirements:"
@echo " uv - Install with: curl -LsSf https://astral.sh/uv/install.sh | sh"
check-uv:
@command -v uv >/dev/null 2>&1 || { \
echo "Error: uv is not installed"; \
echo ""; \
echo "Install uv with:"; \
echo " curl -LsSf https://astral.sh/uv/install.sh | sh"; \
echo ""; \
echo "Or visit: https://github.com/astral-sh/uv"; \
exit 1; \
}
install: check-uv
@echo "Installing Python dependencies with uv..."
@uv sync --group dev
@echo "Dependencies installed in isolated environment (includes dev: pre-commit for git hooks)!"
validate: check-uv
@EXIT=0; \
echo ""; \
echo "======================================================================"; \
echo " Skill Check Tier 1 — agentskills.io spec"; \
echo "======================================================================"; \
echo ""; \
echo "=== Validating skills against agentskills.io spec..."; \
uv run python scripts/validate_skills_tier1.py || EXIT=1; \
echo ""; \
echo "======================================================================"; \
echo " Skill Check Tier 2 — Structure, compliance, design principles"; \
echo "======================================================================"; \
echo ""; \
echo "=== Validating agentic collection structure..."; \
uv run python scripts/validate_structure.py || EXIT=1; \
echo "=== Validating skill docs links..."; \
uv run python scripts/validate_skill_doc_links.py || EXIT=1; \
echo "=== Validating docs tree links..."; \
uv run python scripts/validate_docs_tree_links.py || EXIT=1; \
echo "=== Running compass layout regression tests..."; \
uv run python scripts/test_validate_compass_layout.py || EXIT=1; \
echo "=== Validating collection compliance (.catalog/)..."; \
uv run python scripts/validate_collection_compliance.py || EXIT=1; \
echo "=== Validating Compass manifests..."; \
uv run python scripts/validate_compass_manifests.py || EXIT=1; \
echo "=== Validating Compass lifecycle ceiling (skill <= plugin lifecycle)..."; \
uv run python scripts/validate_lifecycle_ceiling.py || EXIT=1; \
echo "=== Running lifecycle ceiling unit tests..."; \
uv run python scripts/test_validate_lifecycle_ceiling.py || EXIT=1; \
echo "=== Validating MCP tool references (skips gracefully without podman)..."; \
uv run python scripts/validate_mcp_tools.py --summary-only --log-file .validate/mcp-tools.log || EXIT=1; \
echo "=== Validating skill design principles..."; \
uv run python scripts/validate_skills_tier2.py || EXIT=1; \
echo "=== Running spell check..."; \
$(MAKE) validate-spelling || EXIT=1; \
echo "=== Running ruff lint on skill scripts..."; \
$(MAKE) validate-scripts || EXIT=1; \
echo ""; \
echo "======================================================================"; \
echo " Validation complete!"; \
echo "======================================================================"; \
exit $$EXIT
validate-structure: check-uv
@EXIT=0; \
echo "=== Validating agentic collection structure..."; \
uv run python scripts/validate_structure.py || EXIT=1; \
echo "=== Validating skill docs links..."; \
uv run python scripts/validate_skill_doc_links.py || EXIT=1; \
echo "=== Validating docs tree links..."; \
uv run python scripts/validate_docs_tree_links.py || EXIT=1; \
echo "=== Running compass layout regression tests..."; \
uv run python scripts/test_validate_compass_layout.py || EXIT=1; \
echo "=== Validating collection compliance (.catalog/)..."; \
uv run python scripts/validate_collection_compliance.py || EXIT=1; \
echo "=== Validating Compass manifests..."; \
uv run python scripts/validate_compass_manifests.py || EXIT=1; \
echo "=== Validating Compass lifecycle ceiling (skill <= plugin lifecycle)..."; \
uv run python scripts/validate_lifecycle_ceiling.py || EXIT=1; \
echo "=== Running lifecycle ceiling unit tests..."; \
uv run python scripts/test_validate_lifecycle_ceiling.py || EXIT=1; \
echo "=== Validating MCP tool references (skips gracefully without podman)..."; \
uv run python scripts/validate_mcp_tools.py --summary-only --log-file .validate/mcp-tools.log || EXIT=1; \
echo "=== Validation complete!"; \
exit $$EXIT
validate-collection-schema: check-uv
@uv run python scripts/validate_collection_schema.py
validate-collection-compliance: check-uv
@uv run python scripts/validate_collection_compliance.py
validate-compass-manifests: check-uv
@uv run python scripts/validate_compass_manifests.py
validate-lifecycle-ceiling: check-uv
@uv run python scripts/validate_lifecycle_ceiling.py
@uv run python scripts/test_validate_lifecycle_ceiling.py
validate-skill-design: check-uv
@if [ -n "$(PACK)" ]; then \
echo "Error: PACK= was renamed to PLUGIN= (e.g. make validate-skill-design PLUGIN=rh-sre)"; \
exit 1; \
fi
@uv run python scripts/validate_skills_tier2.py $(if $(PLUGIN),$(PLUGIN))
validate-skill-design-changed: check-uv
@VALIDATE_INCLUDE_UNCOMMITTED=1 ./scripts/ci-validate-changed-skills.sh
validate-mcp-tools: check-uv
@if [ -n "$(PACK)" ]; then \
echo "Error: PACK= was renamed to PLUGIN= (e.g. make validate-mcp-tools PLUGIN=rh-sre)"; \
exit 1; \
fi
@echo "Validating MCP tool references against live servers..."
@uv run python scripts/validate_mcp_tools.py $(if $(PLUGIN),$(PLUGIN))
@echo "MCP tool validation complete!"
validate-spelling: check-uv
@echo "Running spell check with codespell..."
@uv run codespell
@echo "Spell check passed!"
validate-scripts: check-uv
@echo "Running ruff lint on skill scripts..."
@uv run ruff check */skills/*/scripts/*.py
@echo "Script lint passed!"
package: check-uv
@uv run python scripts/package_skills.py
clean:
@echo "Cleaning generated files..."
@rm -rf .validate/ dist/
@echo "Cleaned!"