{
 "schema": "aiblocks-page/1",
 "id": "ai-knowledge-file-pack-builder",
 "type": "skill",
 "name": "AI knowledge file pack builder",
 "summary": "Turn your notes and facts into an Open Knowledge Format folder: linked Markdown files your team and AI tools can read, reuse and check.",
 "headline": "AI knowledge file pack builder",
 "subhead": "Share facts, definitions or steps you want to reuse. You get a folder of linked Markdown notes in Open Knowledge Format v0.1, with clear document types and sources. It is a plain folder, not a database or a wiki. The Python checker is optional.",
 "job": {
  "id": "document-work",
  "name": "Write down how work gets done"
 },
 "level": "intermediate",
 "thinking": "high",
 "tested": true,
 "updated": "2026-10-28",
 "first_published": "2026-10-25",
 "inputs": [
  {
   "type": "question",
   "required": true,
   "label": "Question",
   "what": "the problem, decision or piece of work you want help with, and what a good outcome looks like"
  },
  {
   "type": "source_text",
   "required": false,
   "label": "Source text",
   "what": "a long source in full: an article, a video or talk transcript, or notes from a book, with its title, author and link"
  },
  {
   "type": "document",
   "required": false,
   "label": "Document",
   "what": "a finished document, such as a Word file, a PDF or a page of notes"
  }
 ],
 "outputs": [
  {
   "type": "document",
   "required": true,
   "label": "Document",
   "what": "a finished document, such as a Word file, a PDF or a page of notes"
  }
 ],
 "you_give": [
  "The knowledge, sources, document types, stable folder names, and intended readers."
 ],
 "you_get": [
  "A linked Markdown knowledge folder, optional index and change log, and format review notes."
 ],
 "use_when": [
  "You want facts, definitions or steps saved in a form your AI tools can reuse.",
  "You need a folder of notes that links together and cites its sources.",
  "You want to share a body of knowledge with a team or another AI tool."
 ],
 "skip_when": [
  "You want a normal wiki or help pages for people: use a plain wiki or docs tool instead.",
  "You need to check full YAML syntax: use a YAML parser, because the bundled checker only reads a simple subset.",
  "You have one short note to save: keep it in a plain document, no folder needed.",
  "You want a wiki to build up over time from your notes: use the notes wiki builder instead."
 ],
 "output_sample": {
  "input": [
   "Your notes, facts, definitions or steps to reuse",
   "Links or names of your sources",
   "The kind of document each topic should be (optional)",
   "Who will read the folder (optional)"
  ],
  "prerequisites": [
   "An AI that can create files, to get the folder",
   "Python 3.8 or newer with PyYAML, only if you want to run the optional checker"
  ],
  "output": [
   {
    "name": "Concept files",
    "contains": "One Markdown file per idea, each with a type in its header and a body that links to related files."
   },
   {
    "name": "Folders and file paths",
    "contains": "Stable names that group files by topic, so links keep working when you add more."
   },
   {
    "name": "index.md",
    "contains": "An optional list of the files in each folder, with a short line about each one."
   },
   {
    "name": "log.md",
    "contains": "An optional change history with dated headings in year-month-day form."
   },
   {
    "name": "Concept template",
    "contains": "A starter file with the suggested header fields and body sections, such as Schema, Examples and Citations."
   },
   {
    "name": "Format review notes",
    "contains": "What passed and what failed on types, reserved file names and links, from the optional checker."
   }
  ]
 },
 "how_to_use": [
  "Open Claude, ChatGPT or Gemini. Paste the skill, or upload its folder if your AI can read files.",
  "Paste your notes, facts and sources. Say who will read the folder and what each topic should be called.",
  "Ask your AI to write the folder. It must be able to create files. If it cannot, ask it to return the file list and the text of each file, then save each file by hand. Check that each file has a type and that links point to real files.",
  "The bash steps in the skill and the Python checker are for developers. A business user can skip them and ask the AI to write the files. The checker is optional. To run the checker, you need Python 3.8 or newer with PyYAML. Without Python, your AI can still write the folder, and you check the links by hand. Create each folder before you add files to it.",
  "Next, save the folder in a repo or shared drive. Point your AI tool's file access at its index.md. Choose the notes wiki builder if your notes grow over time, the company wiki planner for team processes with owners, or the text to knowledge graph builder to pull links out of one long document."
 ],
 "checks": [],
 "next": [
  {
   "name": "Notes wiki builder",
   "url": "https://useaiblocks.com/skills/notes-wiki-builder",
   "why": "Notes wiki builder"
  },
  {
   "name": "Company wiki planner",
   "url": "https://useaiblocks.com/skills/company-wiki-planner",
   "why": "Company wiki planner"
  },
  {
   "name": "Text-to-knowledge-graph builder",
   "url": "https://useaiblocks.com/skills/text-to-knowledge-graph-builder",
   "why": "Decide what to do"
  }
 ],
 "source": {
  "by": "Magnus Hedemark",
  "repo": "magnus919/agent-skills",
  "url": "https://github.com/magnus919/agent-skills/tree/92c327e525da69c9ad3812fd223a1770e977c2e3/open-knowledge-format",
  "licence": "MIT",
  "original_name": "open-knowledge-format",
  "commit": "92c327e525da69c9ad3812fd223a1770e977c2e3"
 },
 "credits": [
  {
   "title": "open-knowledge-format skill",
   "by": "Magnus Hedemark",
   "url": "https://github.com/magnus919/agent-skills/tree/92c327e525da69c9ad3812fd223a1770e977c2e3/open-knowledge-format",
   "used": "Copied under the MIT licence. We gave it a plain name. We added Before you start and After this sections that link to other AI Blocks steps."
  }
 ],
 "files": [
  "assets/concept-template.md",
  "assets/example-bundle/datasets/index.md",
  "assets/example-bundle/datasets/sales.md",
  "assets/example-bundle/index.md",
  "assets/example-bundle/tables/customers.md",
  "assets/example-bundle/tables/index.md",
  "assets/example-bundle/tables/orders.md",
  "evals/evals.json",
  "LICENSE.md",
  "README.md",
  "references/bundle-architecture.md",
  "references/spec-summary.md",
  "references/use-cases.md",
  "scripts/okf-bundle-validate.py"
 ],
 "links": {
  "page": "https://useaiblocks.com/skills/ai-knowledge-file-pack-builder",
  "markdown": "https://useaiblocks.com/skills/ai-knowledge-file-pack-builder.md",
  "json": "https://useaiblocks.com/skills/ai-knowledge-file-pack-builder.json",
  "instructions": "https://useaiblocks.com/skills/ai-knowledge-file-pack-builder/SKILL.md",
  "download": "https://useaiblocks.com/skills/ai-knowledge-file-pack-builder.zip",
  "api_item": "https://useaiblocks.com/api/v1/items/ai-knowledge-file-pack-builder",
  "api_document": "https://useaiblocks.com/api/v1/documents/skill/ai-knowledge-file-pack-builder",
  "mcp": "https://useaiblocks.com/mcp"
 }
}