# Aif Reference

Create knowledge references from URLs, documents, or files for use by AI agents.

- Repository: https://github.com/lee-to/ai-factory (1156 stars)
- Category: AI and agents
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add lee-to/ai-factory --skill aif-reference -g -a claude-code -y`
Codex: `npx skills add lee-to/ai-factory --skill aif-reference -g -a codex -y`
Cursor: `npx skills add lee-to/ai-factory --skill aif-reference -g -a cursor -y`
Gemini CLI: `npx skills add lee-to/ai-factory --skill aif-reference -g -a gemini-cli -y`

## Description

Create knowledge references from URLs, documents, or files for use by AI agents. Fetch, process, and store structured references in the configured references directory (default: .ai-factory/references/).

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Reference Creator

## Shared project skill-context

Before mode routing or work, read existing files relative to the current project root in this order (reuse them if already loaded):

1. `.ai-factory/skill-context/global-skill-context.md`, all bundled skills.
2. `.ai-factory/skill-context/aif-reference/SKILL.md`, this skill.

Missing files are skipped; an existing unreadable file stops dependent work with its path.
Precedence: individual > build (when applicable) > global > skill defaults; retain non-conflicting instructions and check all outputs against the effective rules.
These layers customize workflow; they do not replace the project's rules/architecture hierarchy or relax explicit requirements, ownership, scope, safety/privacy, validation, or approval boundaries. Report conflicts with those boundaries instead of overriding them.
`global` is a project-local layer, not home-directory configuration. Custom/extension skills do not automatically use it.

Create structured knowledge references from external sources and store them in the configured references directory so other AI Factory skills can reuse them later.

## Step 0: Load Config

**FIRST:** Read `.ai-factory/config.yaml` if it exists to resolve:
- **Paths:** `paths.references` and `paths.rules_file`
- **Language:** `language.ui` for prompts and summaries, `language.artifacts` for generated reference artifacts, and `language.technical_terms` for human-readable technical terminology in references

If config.yaml doesn't exist, use defaults:
- references/: `.ai-factory/references/`
- RULES.md: `.ai-factory/RULES.md`
- `ui_language`: `en`
- `artifact_language`: `en`
- `technical_terms_policy`: `keep`

Resolved language values:
- `ui_language = language.ui || "en"`
- `artifact_language = language.artifacts || language.ui || "en"`
- `technical_terms_policy = language.technical_terms || "keep"`

The rest: https://github.com/lee-to/ai-factory/blob/HEAD/skills/aif-reference/SKILL.md