UNPKG

@alavida/agentpack

Version:

Compiler-driven lifecycle CLI for source-backed agent skills

docs.alavida.ai

alavida-ai/agentpack

124 lines (82 loc) • 2.79 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
--- name: developing-and-testing-skills description: Use when iterating locally on a packaged skill with agentpack author dev, the localhost workbench, repo-local materialization, and runtime testing feedback loops. type: core library: agentpack library_version: "0.1.10" sources: - "alavida-ai/agentpack:docs/cli-skills.mdx" - "alavida-ai/agentpack:docs/introduction.mdx" - "alavida-ai/agentpack:README.md" --- # Agentpack - Developing And Testing Skills ## Setup ```bash cd knowledge-base agentpack author dev domains/value/skills/copywriting ``` ## Core Patterns ### Start local dev with the workbench ```bash agentpack author dev domains/value/skills/copywriting ``` This links the selected skill into `.claude/skills/` and `.agents/skills/`, records the active dev session in `.agentpack/dev-session.json`, and starts a localhost workbench by default. ### Use CLI-only mode when you explicitly do not want the dashboard ```bash agentpack author dev --no-dashboard domains/value/skills/copywriting ``` ### Stop and clean up local links ```bash agentpack author unlink value-copywriting ``` If the previous dev process was killed badly and left stale runtime links behind: ```bash agentpack author dev cleanup ``` If a wrapper-managed process left a false-positive live pid in `.agentpack/dev-session.json`: ```bash agentpack author dev cleanup --force ``` If you need to remove the active root plus its recorded transitive links in one shot: ```bash agentpack author unlink value-copywriting --recursive ``` ## Common Mistakes ### HIGH Expecting the current agent session to pick up new links Wrong: ```bash agentpack author dev domains/value/skills/copywriting ``` Correct: ```bash agentpack author dev domains/value/skills/copywriting # start a fresh agent session if one was already running ``` Already-running agent sessions may not rescan newly materialized skills. Source: README.md ### MEDIUM Assuming unresolved requires block local dev links Wrong: ```bash agentpack author dev domains/value/skills/copywriting # ignore the unresolved warning because linking succeeded ``` Correct: ```bash agentpack author dev domains/value/skills/copywriting agentpack skills status ``` `author dev` can still link the selected skill while warning about unresolved packaged requirements. Use `skills status` to check runtime health. Source: docs/commands.mdx ### MEDIUM Using no-dashboard mode and expecting workbench actions Wrong: ```bash agentpack author dev --no-dashboard domains/value/skills/copywriting ``` Correct: ```bash agentpack author dev domains/value/skills/copywriting ``` `--no-dashboard` suppresses the localhost workbench entirely. Source: docs/introduction.mdx ## References - [Local workbench](references/local-workbench.md)