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)

1. 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)

1. 1. Follow GitFlow: Create feature branches from INLINECODE0
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 INLINECODE1

Repository Structure

CODEBLOCK0

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

Contribute New Knowledge

Quality Standards

Content Requirements

• - 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

• - 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

Content Validation

• - Last updated timestamp is recent
• Content matches current best practices
• Examples work with current tool versions

Reporting Issues

1. 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. 1. Clone the repository: INLINECODE8
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. 1. Fork the repository
2. Follow the contribution guide in INLINECODE11
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