Add an asimov skill. (#1)

Author: SamuelSarle

README.md

@@ -1,9 +1,23 @@
 # ASIMOV Skills
 
-Agent skills for ASIMOV.
+[Agent Skills](https://agentskills.io/) for [ASIMOV](https://github.com/asimov-platform), the open-source personal intelligence platform: installable modules turn your data sources, personal and public, into a context graph connecting the people and information in your life. Installing the skill teaches your agent to set up and drive the [ASIMOV CLI](https://github.com/asimov-platform/asimov-cli).
+
+## Skills
+
+| Skill                    | Teaches                                                            |
+| ------------------------ | ------------------------------------------------------------------ |
+| [asimov](skills/asimov/) | Find, install, and configure modules; retrieve knowledge with them |
 
 ## Installation
 
+Use the [skills CLI](https://skills.sh/) to install them in any supported harness:
+
 ```bash
-npx skills add https://github.com/asimov-platform/skills
+npx skills add asimov-platform/skills
+```
+
+Or just ask your agent:
+
+```text
+Install the ASIMOV Platform for me: https://github.com/asimov-platform/skills
 ```

skills/asimov/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: asimov
+description: Use the ASIMOV CLI to join the user's personal knowledge (such as mail, messages, documents) and public data in one knowledge base. Use when the user mentions ASIMOV, wants their own data in the task, or needs a data source an ASIMOV module handles.
+compatibility: Requires shell and network access
+---
+
+# ASIMOV
+
+ASIMOV is a personal intelligence platform: installable modules turn the user's data sources, personal and public, into a connected knowledge graph, intelligence that knows what it knows. `asimov help` and each subcommand's `--help` are the authority on syntax.
+
+## Setup
+
+```bash
+asimov --version
+```
+
+If missing, ask for the user's approval, then follow <https://github.com/asimov-platform/asimov-cli#installation>.
+
+## Modules
+
+One module per data source. The lifecycle:
+
+```bash
+asimov module search <terms...>   # find modules in the live index
+asimov module install <name>
+asimov module inspect <name>      # manifest, state, config status
+asimov module doc <name>          # the module's README: provider specifics, source URL formats
+asimov module enable <name>
+asimov module resolve <url>       # which enabled module handles this source
+asimov module uninstall <name>
+```
+
+`inspect` prints a hint for anything that still needs doing. Configuration lives under `asimov module config` (`show`, `get`, `set`, `setup`, `unset`). For secrets or interactive setup prefer asking the user to run `asimov module config setup <name>` in their own terminal rather than handling secrets yourself.
+
+## Retrieve
+
+A module's programs (listed by `inspect`) name its operations:
+
+| Program       | Command        | Function                                                            |
+| ------------- | -------------- | ------------------------------------------------------------------- |
+| `*-cataloger` | `asimov list`  | Enumerates the resources a source URL contains (mailbox, feed, ...) |
+| `*-fetcher`   | `asimov fetch` | Retrieves a single resource by URL                                  |
+| `*-reader`    | `asimov read`  | Imports data from a local file or standard input                    |
+| `*-prompter`  | `asimov ask`   | Sends a prompt to the model provider the module wraps               |
+
+## Example
+
+The user wants their browser bookmarks in context:
+
+```console
+$ asimov module search bookmarks
+chromium  Chromium (and Brave, Google Chrome, Arc) bookmark import.
+
+$ asimov module install chromium   # auto-enables when there is nothing to configure
+
+$ asimov module resolve chrome://bookmarks
+chromium
+
+$ asimov list chrome://bookmarks   # also chromium://, brave://, arc://, …
+{"@context":{…},"items":[{"@id":"urn:uuid:","@type":"know:Bookmark","created":"2025-09-27T04:30:00.000000Z","title":"ASIMOV Platform · GitHub","link":"https://github.com/asimov-platform"},…]}
+
+$ asimov list -M chromium chrome://bookmarks   # same, with the module pinned explicitly
+```
+
+URLs resolve to modules automatically. The `resolve` check and `-M` are optional.
+
+## Links
+
+- The platform, its CLI, SDK, and specifications: <https://github.com/asimov-platform>
+- The modules: <https://github.com/asimov-modules>
+- The company: <https://github.com/asimov-systems>