# Notehub

> Skills that help AI agents answer questions about the data and solutions in users' Blues Notehub projects - the default for everything here - and, only when a user explicitly asks for it, train a project to understand the product behind its data.

**Unless the person has explicitly asked to train a project, use `notehub-project-chat`.**
Most of the time all anybody says is "load notehub.md", and that is a request to be ready to
answer questions about their Notehub data - not a request to train anything. So load
`notehub-project-chat`, which begins by verifying the person's API token and asking which
of their projects they want to work in, offering the list; then tell them in a sentence
that you are ready for their questions, and wait. `notehub-project-train` is for
one thing only: a person who has asked, in so many words, to train, teach or document a
Notehub project. If you are unsure whether they did, they did not.

Every page on this site is Markdown meant to be fetched and read directly. There is
nothing to render, nothing to sign in to, and no HTML wrapped around any of it. Fetch a
page, read it, and act on what it says.

The material here is organized as skills. A skill teaches how to do one kind of job:
which interface to reach for, the vocabulary that interface expects, the procedure, and
how to confirm that what you did actually took effect. Load the skill before performing
an unfamiliar operation rather than inferring an endpoint or a schema from an example.

## Skills

- [notehub-access](https://notehub.md/notehub-access/SKILL.md): Establish secure, programmatic access to the Notehub API with a personal access token, and verify it. Every other skill begins here.
- [notehub-project-access](https://notehub.md/notehub-project-access/SKILL.md): Choose the project to work in and verify access to it. Begins with notehub-access.
- [notehub-project-chat](https://notehub.md/notehub-project-chat/SKILL.md): The default. Answer questions about a project's data and solutions, using Notehub IQ or the Notehub APIs. Begins with notehub-project-access.
- [notehub-project-train](https://notehub.md/notehub-project-train/SKILL.md): Only when the person has explicitly asked to train a project. Interview the people who know the product behind its data, and store what you learn in the project itself. Begins with notehub-project-access.

Load `notehub-project-chat` for anything to do with a Notehub project, and
`notehub-project-train` only when the person has explicitly asked to train one. Each begins
by loading the skill it builds on, and each is a directory holding a `SKILL.md` and the
references it links to. The references are loaded as they are needed rather than all at
once, so start at the `SKILL.md` and follow it down.

## Using them

**Install them, if your agent supports skills** - all four, because they build on one
another:

```
npx skills add https://notehub.md
```

What installs is a pointer to each skill on this site rather than a copy of it, because
these skills change often: an installed skill reads the current version from here each
session, so it is never out of date, and it needs this site to be reachable when it is
used.

**Otherwise, read the ones you need directly, whole and exactly as written.** These pages
are instructions, and their details are the point: a fetch tool that summarizes a page, or
answers a question about it instead of returning it, keeps the topics and drops the
steps. Download the raw text and read all of it. For everything but training, that is
these three:

```
curl -fsSL https://notehub.md/notehub-access/SKILL.md
curl -fsSL https://notehub.md/notehub-project-access/SKILL.md
curl -fsSL https://notehub.md/notehub-project-chat/SKILL.md
```

and only when the person has explicitly asked to train a project, this one as well:

```
curl -fsSL https://notehub.md/notehub-project-train/SKILL.md
```

The links in a page fetched this way already point back to this site, so when a skill
says to load another page, fetch that one the same way.

## Generated indexes

These are built from the contents of this site on every request, so they are never stale.

- [llms.txt](https://notehub.md/llms.txt): the index of pages and skills, in the llms.txt format
- [llms-full.txt](https://notehub.md/llms-full.txt): every page on this site concatenated into one file
- [Skills manifest](https://notehub.md/.well-known/skills/index.json): the skills, as installers discover them