|
2 | 2 |
|
3 | 3 | A collection of AI/LLM configuration files and [agent skills](https://agentskills.io/) for various tools and platforms. |
4 | 4 |
|
5 | | -## About |
| 5 | +## Documentation |
6 | 6 |
|
7 | | -This repository contains configuration files for AI coding assistants and LLMs, including: |
8 | | -- **CLAUDE.md / AGENTS.md** - Instructions for Claude Code and others AI agents |
9 | | -- **Agent skills** - Custom skills for specialized tasks |
| 7 | +Full documentation is available at **[s-celles.github.io/ai-config](https://s-celles.github.io/ai-config/)** |
10 | 8 |
|
11 | | -The agent skills were generated using **Claude Opus 4.5** and its skill-creation capabilities. |
| 9 | +- [Standards for Sharing Agents and Skills](https://s-celles.github.io/ai-config/docs/) |
| 10 | +- [Available Skills](https://s-celles.github.io/ai-config/docs/skills/) |
12 | 11 |
|
13 | | -## Standards for Sharing Agents and Skills |
| 12 | +## Repository Structure |
14 | 13 |
|
15 | | -The AI ecosystem has several emerging standards for describing and sharing agents, skills, and context. In December 2025, the [Linux Foundation announced the Agentic AI Foundation (AAIF)](https://www.linuxfoundation.org/press/linux-foundation-announces-the-formation-of-the-agentic-ai-foundation) to govern several of these standards. |
| 14 | +``` |
| 15 | +ai-config/ |
| 16 | +├── ai/ |
| 17 | +│ ├── agents/ # Agent configurations |
| 18 | +│ ├── commands/ # Command definitions |
| 19 | +│ └── skills/ # Agent skills (SKILL.md files) |
| 20 | +├── site/ # Hugo website source |
| 21 | +└── AGENTS.md # Instructions for AI coding agents |
| 22 | +``` |
16 | 23 |
|
17 | | -### Agent Standards |
| 24 | +## Quick Start |
18 | 25 |
|
19 | | -| Standard | Purpose | Format | Link | |
20 | | -|----------|---------|--------|------| |
21 | | -| **AGENTS.md** | Project-specific guidance for AI coding agents | Markdown | [AAIF](https://www.linuxfoundation.org/press/linux-foundation-announces-the-formation-of-the-agentic-ai-foundation) | |
22 | | -| **Agent Manifest** (ADS) | Describes autonomous AI agents capabilities, authentication, and execution | `manifest.json` | [agent-manifest.org](https://agent-manifest.org/) | |
23 | | -| **Open Agent Specification** | Framework-agnostic declarative agent specification | YAML/JSON | [Oracle Blog](https://blogs.oracle.com/ai-and-datascience/introducing-open-agent-specification) | |
24 | | -| **OASF** | Open Agentic Schema Framework for agent interoperability | JSON Schema | [AGNTCY](https://intuitionlabs.ai/articles/agentic-ai-foundation-open-standards) | |
| 26 | +To use a skill, copy its directory to your skills folder or reference it in your configuration: |
25 | 27 |
|
26 | | -### Skill Standards |
27 | | - |
28 | | -| Standard | Purpose | Format | Link | |
29 | | -|----------|---------|--------|------| |
30 | | -| **Agent Skills** (SKILL.md) | Human-readable skill instructions for AI assistants | Markdown + YAML | [agentskills.io](https://agentskills.io/) | |
31 | | -| **Skill Manifest** | Bot skills with endpoints, activities, and I/O schemas | `skills-manifest.json` | [Microsoft Bot Framework](https://learn.microsoft.com/en-us/azure/bot-service/skills-write-manifest) | |
32 | | -| **GPT Actions** | API integration for ChatGPT custom GPTs | OpenAPI 3.1.0 | [OpenAI Platform](https://platform.openai.com/docs/actions/introduction) | |
33 | | - |
34 | | -### Context & Communication Protocols |
35 | | - |
36 | | -| Standard | Purpose | Format | Link | |
37 | | -|----------|---------|--------|------| |
38 | | -| **MCP** | Model Context Protocol for agent-to-tool communication | JSON-RPC | [modelcontextprotocol.io](https://modelcontextprotocol.io/specification/2025-06-18) | |
39 | | -| **llms.txt** | Website content structured for LLM consumption | Markdown | [llmstxt.org](https://llmstxt.org/) | |
40 | | - |
41 | | -### Summary |
42 | | - |
43 | | -- **AGENTS.md** - OpenAI standard adopted by 60,000+ projects; provides project-specific agent guidance |
44 | | -- **Agent Skills / SKILL.md** - Anthropic standard adopted by Microsoft, OpenAI, Atlassian, Figma, Cursor, GitHub |
45 | | -- **MCP** - De facto standard for agent-to-tool communication with 97M+ monthly SDK downloads |
46 | | -- **GPT Actions** - OpenAI's OpenAPI-based format for ChatGPT integrations |
47 | | -- **llms.txt** - Emerging standard for making website content LLM-friendly |
48 | | - |
49 | | -## Skills |
50 | | - |
51 | | -### Tested |
52 | | - |
53 | | -### wiki-generator-lsp |
54 | | - |
55 | | -An automated documentation generator that creates comprehensive WIKI.md files for codebases. |
56 | | - |
57 | | -- Uses Language Server Protocol (LSP) for precise code analysis |
58 | | -- Supports TypeScript, JavaScript, Python, Go, Rust, Java, and C/C++ |
59 | | -- Generates Mermaid diagrams for architecture visualization |
60 | | -- Creates structured documentation with project overview, architecture, API reference, and development guides |
61 | | - |
62 | | -### license-advisor |
63 | | - |
64 | | -An expert assistant for choosing the right license for any type of creation. |
65 | | - |
66 | | -- Guides users through a comprehensive questionnaire to understand their needs |
67 | | -- Covers all license types: open-source, Creative Commons, proprietary, public domain, and dual licensing |
68 | | -- Supports software, creative works, data, fonts, hardware designs, AI models, and more |
69 | | -- Provides detailed recommendations with explanations, compatibility notes, and official links |
70 | | -- Responds in the user's language |
71 | | - |
72 | | -> **See also:** [foss-license-advisor](#foss-license-advisor) for a focused FOSS-only version |
73 | | -
|
74 | | -### foss-license-advisor |
75 | | - |
76 | | -An expert assistant specialized in free and open-source licenses (FOSS). |
77 | | - |
78 | | -- Focused exclusively on OSI-approved and FSF-approved free/open licenses |
79 | | -- Guides users through copyleft vs permissive license decisions |
80 | | -- Covers GPL, MIT, Apache, BSD, LGPL, MPL, AGPL, Creative Commons (free licenses only), and more |
81 | | -- Includes French-specific licenses (CeCILL family, Etalab) for French legal context |
82 | | -- Deep dive into copyleft concepts: strong, weak, and network copyleft |
83 | | -- Responds in the user's language |
84 | | - |
85 | | -> **See also:** [license-advisor](#license-advisor) if you need proprietary or commercial licensing options |
86 | | -
|
87 | | -### Experimental |
88 | | - |
89 | | -> ⚠️ **Warning**: The thesis-related skills below are experimental and have not been tested in real-world academic contexts. Additionally, I do not hold a PhD myself, so these skills are based on research and documentation rather than personal experience. Use with caution and always verify guidance with your academic supervisors. |
90 | | -
|
91 | | -#### these-scientifique-fr |
92 | | - |
93 | | -A French-language assistant for scientific thesis writing in the French academic context. |
94 | | - |
95 | | -- Guides doctoral students through thesis writing following French academic standards |
96 | | -- Provides templates for thesis proposals, manuscript structure, literature analysis, and defense preparation |
97 | | -- Covers French-specific doctoral processes (doctoral schools, CSI annual monitoring, HDR qualifications) |
98 | | -- Supports both monograph and article-based thesis formats |
99 | | - |
100 | | -> **See also:** [thesis-assistant](#thesis-assistant) for the English-language version |
101 | | -
|
102 | | -#### thesis-assistant |
103 | | - |
104 | | -An English-language PhD thesis writing assistant providing comprehensive academic guidance. |
105 | | - |
106 | | -- Supports all stages of thesis development: proposal, literature review, methodology, drafting, and defense |
107 | | -- Provides templates for proposals, article analysis, synthesis matrices, and chapter outlines |
108 | | -- Discipline-agnostic guidance applicable across sciences, humanities, and social sciences |
109 | | -- Supports multiple thesis structures: monograph, three-paper model, or practice-based formats |
110 | | - |
111 | | -> **See also:** [these-scientifique-fr](#these-scientifique-fr) for the French-language version with France-specific guidance |
112 | | -
|
113 | | -## Usage |
114 | | - |
115 | | -To use these skills, copy the skill directory to your skills folder or reference them in your configuration. |
116 | | - |
117 | | -> **Note:** These skills are designed as starting points and may need to be adapted to your specific context, workflow, or requirements. Feel free to modify the SKILL.md files, adjust the questionnaires, update the reference templates, or add your own domain-specific knowledge to better fit your needs. |
118 | | -
|
119 | | -## Disclaimer |
120 | | - |
121 | | -These skills are provided for informational and educational purposes only. They do not constitute legal, academic, or professional advice. The guidance provided by these skills should not be relied upon as a substitute for consultation with qualified professionals (lawyers, academic supervisors, etc.). |
122 | | - |
123 | | -The author(s) of these skills: |
124 | | -- Make no warranties regarding the accuracy, completeness, or reliability of the information provided |
125 | | -- Accept no liability for any damages, losses, or consequences arising from the use of these skills |
126 | | -- Strongly recommend verifying all information with qualified professionals before making decisions |
127 | | - |
128 | | -**By using these skills, you acknowledge that you do so at your own risk.** |
| 28 | +```bash |
| 29 | +# Example: copy the license-advisor skill |
| 30 | +cp -r ai/skills/license-advisor ~/.claude/skills/ |
| 31 | +``` |
129 | 32 |
|
130 | 33 | ## License |
131 | 34 |
|
|
0 commit comments