You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 11e8ce8
Browse filesBrowse the repository at this point in the historyBrowse files
docs(skill): note the CLI and MCP prerequisite and version skew (#210)
- SKILL.md: new "What this skill needs" section, with an `osw schema --help` preflight and a stop instruction when neither the CLI nor an MCP tool is present
- SKILL.md: new "Troubleshooting" section, comparing `metadata.version` against `osw --version`; nothing checks this automatically
- SKILL.md: shorter description, keeping the triggers and dropping the list of covered sections
- docs/tools/cli.md: the plugin marketplace path installs the skill file only, not the package or the MCP server
Copy file name to clipboardExpand all lines: src/osw/skills/osl-tasks/SKILL.md
+28-1Lines changed: 28 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
2
name: osl-tasks
3
-
description: Use when importing local todo or note files into an OpenSemanticLab (OSL) wiki as Task entities, or when listing, filtering and updating tasks that already live in OSL. Drives the generic entity, schema and search operations of the `osw` CLI and MCP server; there are no task-specific commands. Covers the Task, Person and Project category page names, how to read the status and priority vocabularies from the schema, the update-by-uuid rule, the duplicate rule and the link marker written back into the local file.
3
+
description: Use when importing local todo or note files into an OpenSemanticLab (OSL) wiki as Task entities, or when listing, filtering and updating tasks that already live in OSL. Requires the `osw` CLI or the osw MCP server.
4
4
metadata:
5
5
version: "2.8.0"
6
6
---
@@ -18,6 +18,17 @@ mistakes silently produce a wrong result.
18
18
Commands are shown in CLI form. Each one has an MCP tool with the same
19
19
parameters; the tool name is given in the table below.
20
20
21
+
## What this skill needs
22
+
23
+
This skill calls the `osw` CLI or the osw MCP server, and installing the skill
24
+
file or the `osl-tasks` plugin installs neither of them. Run `osw schema
25
+
--help` first. It fails when the CLI is missing, and when it is old enough to
26
+
lack the command groups below. It does not tell you whether the version
27
+
matches this file. Troubleshooting covers that. If it fails and this session
28
+
has no osw MCP tool, ask the
29
+
user to install the `osw` package, plus the `mcp` extra and a registered
30
+
server for the MCP tools. Then stop.
31
+
21
32
## When to use this skill
22
33
23
34
- Importing todos or notes from a local file into OSL.
@@ -339,3 +350,19 @@ and reversible. A skipped todo is silent and loses work.
339
350
update, not create.
340
351
- Anything weaker than an exact label match is a candidate. Show the
341
352
candidates to the user and let them decide. Do not resolve it yourself.
353
+
354
+
## Troubleshooting
355
+
356
+
Nothing checks that this file and the installed `osw` package come from the
357
+
same release, although both versions are set together when a release is made.
358
+
Compare `metadata.version` in this file's frontmatter with the version that
359
+
`osw --version` prints. With the MCP server and no CLI, ask the user for the
360
+
version of the `osw` package that serves it.
361
+
362
+
If the two differ, this file can describe operations, flags or field names
363
+
that the installed package does not have, or omit ones it does have.
364
+
Reinstall with `osw skill install --force`, or update the `osl-tasks` plugin,
365
+
or update the `osw` package, until both report the same version.
366
+
367
+
If this file's frontmatter has no `metadata.version` at all, the copy is older
368
+
than the release that added that field. Reinstall it.
0 commit comments