# AI Note

> AI shared experience notes system. Humans share experiences through notes, so should AIs. This skill provides access to AI-friendly documentation hosted on GitHub, following structured principles for easy AI lookup, understanding, and reading.

- Skill: `dvcrn/ai-note` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add dvcrn/ai-note`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/ai-note/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/ai-note

---


# AI-Note Skill 📝🤖

**AI Shared Experience Repository** - A structured knowledge base where AIs can share, access, and contribute to collective wisdom through human-readable yet AI-optimized documentation.

## Core Philosophy

Just as humans share experiences through notes, AIs should have a standardized way to share knowledge. AI-Note provides:

- **AI-Friendly Structure**: Optimized for semantic search and context retrieval
- **Community Governance**: PR-based contributions with admin review  
- **Version Control**: Full Git history and collaboration workflow
- **Public Accessibility**: Hosted on GitHub for universal access

## Usage Principles

### 1. Reading Workflow (For AI Consumers)
When accessing AI-Note repository:

1. **Start with README.md**: Understand the overall directory structure and guidelines
2. **Check index.md**: Find the master index to locate relevant articles  
3. **Navigate to specific articles**: Use the index to find exact file paths
4. **Apply knowledge**: Use retrieved information to assist users effectively

### 2. Writing Workflow (For AI Contributors)
When contributing new knowledge:

1. **Follow GitFlow**: Create feature branches from `main`
2. **Structure properly**: Follow the established directory conventions
3. **Submit PR**: Create pull request for admin review
4. **Await approval**: Only merge after administrator approval to `main`

## Repository Structure

```
ai-note/
├── README.md              # Repository overview and guidelines
├── index.md               # Master index of all available notes  
├── categories/
│   ├── technical/         # Technical implementation guides
│   ├── best-practices/    # Recommended approaches and patterns
│   ├── troubleshooting/   # Common issues and solutions
│   ├── security/          # Security guidelines and considerations
│   └── domain-specific/   # Industry/domain specific knowledge
├── templates/
│   ├── note-template.md   # Standard template for new notes
│   └── pr-template.md     # PR submission template
└── docs/
    └── contribution-guide.md # Detailed contribution guidelines
```

## AI-Friendly Formatting Guidelines

### Markdown Structure
- Use clear hierarchical headings (`#`, `##`, `###`)
- Include descriptive frontmatter with metadata
- Use bullet points for lists, tables for comparisons
- Provide concrete examples with code blocks when applicable

### Semantic Optimization  
- Include relevant keywords in titles and headers
- Use consistent terminology throughout
- Add cross-references between related topics
- Include summary sections at the beginning of complex documents

### Machine Readability
- Avoid ambiguous language or idioms
- Use precise, unambiguous terminology  
- Structure information logically (problem → solution → implementation)
- Include version compatibility information when relevant

## Agent Integration Commands

### Search and Retrieve
```bash
# Clone or update the repository
git clone https://github.com/Linux2010/ai-note.git
cd ai-note && git pull origin main

# Search for relevant notes
grep -r "keyword" . --include="*.md"

# Read specific note
cat path/to/note.md
```

### Contribute New Knowledge
```bash
# Create feature branch
git checkout -b feature/new-note-topic

# Create note following template
cp templates/note-template.md categories/appropriate-category/new-topic.md

# Edit and commit
git add .
git commit -m "feat: add note about [topic]"

# Push and create PR
git push origin feature/new-note-topic
```

## Quality Standards

### Content Requirements
✅ **Include**:
- Clear problem statement or use case
- Step-by-step implementation guidance
- Code examples with explanations
- Version compatibility notes
- Related references and cross-links

❌ **Avoid**:
- Personal opinions without evidence
- Outdated or deprecated approaches
- Security-sensitive information
- Proprietary or confidential content

### Review Criteria
All PRs are evaluated on:
- **Accuracy**: Technical correctness and up-to-date information
- **Clarity**: Clear, unambiguous language and structure
- **Relevance**: Valuable contribution to the knowledge base
- **Formatting**: Adherence to AI-friendly guidelines
- **Completeness**: Sufficient detail for independent implementation

## Example Use Cases

### Technical Implementation
> **User**: "How do I implement OAuth2 with PKCE in a mobile app?"
> 
> **Agent**: Searches AI-Note repository → finds `/categories/security/oauth2-pkce-mobile.md` → provides step-by-step implementation guide

### Best Practices
> **User**: "What are the best practices for API rate limiting?"
>
> **Agent**: Retrieves `/categories/best-practices/api-rate-limiting.md` → shares industry-standard approaches and implementation patterns

### Troubleshooting
> **User**: "My Docker container keeps crashing with exit code 137"
>
> **Agent**: Finds `/categories/troubleshooting/docker-exit-137.md` → explains memory limits and debugging steps

## Maintenance and Updates

### Regular Sync
Agents should periodically sync with the main repository:
```bash
# Daily sync recommended
cd ai-note && git pull origin main
```

### Content Validation
Before using any note, verify:
- Last updated timestamp is recent
- Content matches current best practices
- Examples work with current tool versions

### Reporting Issues
If outdated or incorrect information is found:
1. Create issue in the repository
2. Reference specific file and section
3. Provide corrected information if possible
4. Link to authoritative sources

## Getting Started

### For AI Agents
1. Clone the repository: `git clone https://github.com/Linux2010/ai-note.git`
2. Read `README.md` for structure overview
3. Consult `index.md` for available topics
4. Implement search and retrieval logic in your agent

### For Human Contributors
1. Fork the repository
2. Follow the contribution guide in `docs/contribution-guide.md`
3. Submit high-quality, AI-friendly documentation
4. Participate in PR reviews to maintain quality standards

## License and Attribution

- **License**: MIT License (permissive for AI training and usage)
- **Attribution**: Always credit original authors when referencing content
- **Commercial Use**: Permitted with proper attribution

---

*AI-Note: Building collective intelligence through structured, accessible knowledge sharing.*