Ship agent skills from the repo root (skills/), installable via skills.sh
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 86/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- markdown, yaml
- Domain
- developer-experience, documentation
Research direction
Start by reading packages/ledger to understand the ledger layout and safe read-only behavior, then add skills/read-pbnotes-ledger/SKILL.md. Follow the example from the skills CLI for required YAML frontmatter and verify that npx skills add shovon/pbnotes discovers the skill. Done means the skill is discoverable, contains installation guidance in AGENTS.md, and provides guidance only with no scripts that modify a ledger.
Written by the indexing model from the issue text.
Description
Agents that land in a pbnotes ledger (see #63) need to know how to read it. Rather than copying a skill into every ledger, ship it from this repo so users install it once and it updates with the code.
Proposal
Add skills under skills/<name>/SKILL.md at the repo root, e.g.:
skills/
read-pbnotes-ledger/
SKILL.md # what a ledger is, its layout, how to read it safely
This is one of the paths the `skills` CLI (vercel-labs/skills) searches, so users can install with:
npx skills add shovon/pbnotes
and it works across Claude Code, Codex, Cursor, etc. Each SKILL.md needs YAML frontmatter with name (lowercase, hyphens) and description; without both the CLI finds nothing.
Keeping the skill next to `packages/ledger` means a format change and the skill update land in the same commit.
Follow-ups / open questions
- The
AGENTS.mdsignpost from #63 should name the install command above. - Optional: a
.claude-plugin/marketplace.jsonpointing at the sameskills/folder would also make it installable as a Claude Code plugin (/plugin marketplace add shovon/pbnotes) with no separate repo. Only if wanted. - skills.sh listing appears to come from installs of public repos; nothing to submit, but confirm once published.
- Skills must stay read-only guidance: no scripts that write into a ledger.
- Dominant language
- TypeScript
- Stars
- 0
- Forks
- 1
- Avg merge
- 31m
- Merged PRs (30d)
- 25
Getting set up
This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from shovon/pbnotes
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
Maintainers usually reply within 1 day
-
Website for Pb NotesOpenenhancement
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
Maintainers usually reply within 1 day
-
Delete a pageOpenenhancement
Difficulty 5/5 Over a week Newbie friendliness 48/100
Maintainers usually reply within 1 day
-
enhancement
Difficulty 4/5 3-5 days Newbie friendliness 55/100
Maintainers usually reply within 1 day
-
enhancement
Difficulty 4/5 3-5 days Newbie friendliness 55/100
Maintainers usually reply within 1 day
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
marmelab/react-admin#11431 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
db-ux-design-system/core-web#8655 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
Maintainers usually reply within 1 day
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
stripe/react-stripe-js#728 ·
-
[Upload Grade C dataset] the pop-up changes it's size while uploading the document => Jumping effectOpenbug
Difficulty 2/5 1-3 hours Newbie friendliness 66/100
epam/statgpt-admin-frontend#305 ·
Maintainers usually reply within 1 day