observablehq / observablehq/notebook-kit

Add official LLM documentation / Claude Code skill

Open
#117 1 comment 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
371
Forks
27
Avg merge
3h 52m
Merged PRs (30d)
1

Description

I just found out about Notebooks 2.0 yesterday and I'm quite liking it so far!

I work a lot with Claude Code, and especially like their skills system, where skills are loaded dynamically when needed. I made Claude build a skill to write Observable Notebooks, but it's probably full of errors. It would be super nice if there was an official doc of sorts for LLMs to digest and learn how to build notebooks. Or a skill, which is now supported by all major coding agents AFAIK.

I know you're building the desktop notebook editor as well, and I don't know your business strategy around this, so maybe it's not something you want. But here's the suggestion anyway.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the linked Observable Notebooks skill and the repository's existing documentation to understand what guidance already exists. The issue does not name project files, tests, or a defined documentation scope; done would require an agreed decision on whether to provide official LLM documentation, a Claude Code skill, or both.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.