Skip to content

Commit 3f2e4eb

Browse files
committed
simplify README: move detailed content to website
1 parent 405cbfa commit 3f2e4eb

1 file changed

Lines changed: 20 additions & 117 deletions

File tree

README.md

Lines changed: 20 additions & 117 deletions
Original file line numberDiff line numberDiff line change
@@ -2,130 +2,33 @@
22

33
A collection of AI/LLM configuration files and [agent skills](https://agentskills.io/) for various tools and platforms.
44

5-
## About
5+
## Documentation
66

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/)**
108

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/)
1211

13-
## Standards for Sharing Agents and Skills
12+
## Repository Structure
1413

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+
```
1623

17-
### Agent Standards
24+
## Quick Start
1825

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:
2527

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+
```
12932

13033
## License
13134

0 commit comments

Comments
 (0)