UNPKG

@alavida/agentpack

Version:

Compiler-driven lifecycle CLI for source-backed agent skills

docs.alavida.ai

alavida-ai/agentpack

111 lines (76 loc) • 2.28 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
--- name: maintaining-skillgraph-freshness description: Use when validating authored skills, checking stale state, and keeping compiled metadata aligned with changing knowledge in an agentpack skillgraph. type: lifecycle library: agentpack library_version: "0.1.10" sources: - "alavida-ai/agentpack:docs/cli-skills.mdx" - "alavida-ai/agentpack:docs/staleness.mdx" - "alavida-ai/agentpack:README.md" --- # Agentpack - Maintaining Skillgraph Freshness ## Setup ```bash cd knowledge-base agentpack publish validate domains/value/skills/copywriting agentpack author stale git add .agentpack/compiled.json ``` ## Core Patterns ### Use stale before and after source changes ```bash agentpack author stale edit domains/value/knowledge/tone-of-voice.md agentpack author stale ``` ### Revalidate to refresh the baseline ```bash agentpack publish validate domains/value/skills/copywriting ``` ### Commit authored metadata ```bash git add .agentpack/compiled.json git commit -m "chore: refresh skill metadata" ``` ## Common Mistakes ### CRITICAL Treating stale detection as automatic without validate Wrong: ```bash edit domains/value/knowledge/tone-of-voice.md agentpack author stale ``` Correct: ```bash edit domains/value/knowledge/tone-of-voice.md agentpack author stale agentpack publish validate domains/value/skills/copywriting ``` The stale baseline only updates on successful validation. Source: docs/cli-skills.mdx ### HIGH Not committing compiled state in authoring repos Wrong: ```bash git add domains/value/skills/copywriting git commit -m "feat: update copywriting" ``` Correct: ```bash git add domains/value/skills/copywriting .agentpack/compiled.json git commit -m "feat: update copywriting" ``` Uncommitted compiled metadata breaks stale visibility across clones, CI, and teammates. Source: README.md ### MEDIUM Using install-state as authored provenance Wrong: ```text .agentpack/install.json is treated as the authored source of truth ``` Correct: ```text .agentpack/compiled.json is the authored metadata file ``` Install-state describes runtime materialization, not authored source freshness. Source: docs/staleness.mdx ## References - [Authored metadata](../authoring-skillgraphs-from-knowledge/references/authored-metadata.md)