@falkenslab/agent-kit 0.16.1 → 0.18.0

package/assets/knowledge-plugin-files/skills/knowledge-pages/SKILL.md

@@ -1,137 +0,0 @@
----
-name: knowledge-pages
-description: Exact templates and conventions for every page of the knowledge base (index, log, overview, summary, concept, entity and synthesis pages) - load it before creating a knowledge base page or restructuring one, so every page keeps the same shape and links.
----
-
-# Knowledge base page templates
-
-The knowledge base's layout and rules are in the system prompt ("Knowledge base"). This skill only adds the exact shape of each page. Headings and frontmatter keys stay in English (they are structure); the text under them is in the human's language. Dates are `YYYY-MM-DD`. Links are relative markdown links (from `concepts/x.md`, a summary is `../summaries/y.md`; an original file is `../../sources/...`, adjusted to where the folders really are).
-
-Every page starts with YAML frontmatter; `updated` changes whenever you edit the page.
-
-## index.md
-
-The catalog and entry point. One line per page, grouped by section: Summaries, Concepts, Entities, Syntheses (plus any section the domain adds).
-
-```markdown
-# Index
-
-## Summaries
-- [Q3 architecture review](summaries/q3-architecture-review.md) - decisions taken on the billing service
-## Concepts
-- [Idempotency](concepts/idempotency.md) - safe retries of a request
-```
-
-## log.md
-
-Append-only; never edit past entries. Newest at the bottom.
-
-```markdown
-## [2026-10-03] ingest | Q3 architecture review
-- created: summaries/q3-architecture-review.md, concepts/idempotency.md
-- updated: entities/billing-service.md, index.md
-```
-
-## overview.md
-
-A living synthesis of the whole knowledge base, rewritten (not appended) as understanding grows: what it covers, its main blocks and how they connect (with links), what is still unknown.
-
-## Summary page (`summaries/<slug>.md`)
-
-One per ingested source.
-
-```markdown
----
-type: summary
-title: "<Title>"
-file: <relative link to the original in sources/, if any>
-url: <original URL, if any>
-ingested: YYYY-MM-DD
-updated: YYYY-MM-DD
----
-
-# <Title>
-
-## Summary
-<Two to four paragraphs: what it actually says.>
-
-## Key points
-- Claims, definitions or figures likely to be needed later, quoted literally when exact wording matters.
-
-## Pages it feeds
-- [Concept or entity](../concepts/<slug>.md)
-
-## New or surprising
-- What this source adds to what the knowledge base already had.
-
-## Contradictions
-- Conflicts with other pages, linked.
-```
-
-## Concept page (`concepts/<slug>.md`)
-
-One idea per page.
-
-```markdown
----
-type: concept
-aliases: []
-updated: YYYY-MM-DD
----
-
-# <Concept>
-
-<Definition in one or two sentences.>
-
-## Explanation
-<How it works, at the depth the sources give.>
-
-## Connections
-- Requires: [Concept](<slug>.md)
-- Related: [Concept](<slug>.md) - how
-
-## Sources
-- [Summary](../summaries/<slug>.md) - what it says about this
-
-## Contradictions and open questions
-- "<Source A> says X; <source B> says Y" - both attributed.
-```
-
-## Entity page (`entities/<slug>.md`)
-
-A concrete thing: a system, a component, an organization, a document, a person only when they are a public role rather than private individual details.
-
-```markdown
----
-type: entity
-kind: <system | component | organization | document | other>
-aliases: []
-updated: YYYY-MM-DD
----
-
-# <Name>
-
-<What it is, one or two sentences.>
-
-## Facts
-- Attributed facts, each linking the summary or source it comes from.
-
-## Connections
-- [Concept or entity](../concepts/<slug>.md) - how
-```
-
-## Synthesis page (`syntheses/<slug>.md`)
-
-An answer worth keeping: a comparison, an analysis, a report.
-
-```markdown
----
-type: synthesis
-question: "<The question it answers>"
-updated: YYYY-MM-DD
----
-
-# <Title>
-
-<The answer, with links to every page it draws on.>
-```

package/assets/knowledge-plugin-files/skills/knowledge-query/SKILL.md

@@ -1,14 +0,0 @@
----
-name: knowledge-query
-description: Answer a question from the knowledge base - find the relevant pages through the index, read them, answer with links to them, and file the answer back as a synthesis page when it is worth keeping.
----
-
-# Querying the knowledge base
-
-The knowledge base exists so a question doesn't start from zero. Answer from it first; go back to the originals or the web only for what it doesn't hold.
-
-1. **Start from the index.** Read `index.md`, pick the pages that can matter, read those (not the whole knowledge base). `Grep` inside the knowledge base for terms and aliases the index doesn't reveal.
-2. **Answer from the pages**, linking each one you drew on. Say what comes from the knowledge base, what comes from an original in the sources folder (read it if the knowledge base is thin or contradictory) and what comes from outside (label it as such).
-3. **Say what is missing.** If the knowledge base can't answer part of the question, say so and name the source that would fill it, instead of filling the gap from memory silently.
-4. **File it back.** If the answer is a comparison, an analysis or a report that will be asked again, save it as `syntheses/<slug>.md` (template in `knowledge-pages`) with links to its inputs, add it to `index.md`, and log it: `## [date] query | <question>`. A quick factual answer needs no page.
-5. **Feed the knowledge base.** If answering revealed a concept or fact that has no page, or a contradiction, fix that in the knowledge base too and log it.