mirror of
https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools.git
synced 2025-12-16 21:45:14 +00:00
cb8bb88b4f
This commit represents a comprehensive refactor and enhancement of the entire repository, transforming it from a simple collection to a searchable, analyzable, and well-documented resource. ## Fixed Issues - Fixed broken link for Amp directory (./AMp/ → ./Amp/) - Added missing Emergent and Traycer AI entries to README - Fixed file extension for Traycer AI/plan_mode_prompts.txt - Updated line count statistics for accuracy (30,000+ → 25,000+) ## New Infrastructure - Created scripts/ directory with automation tools - Added .gitignore for generated files and common artifacts - Implemented comprehensive metadata system ## New Scripts - generate_metadata.py: Generate searchable index with tool metadata - validate.py: Automated repository validation and quality checks - search.py: Search and filter tools by multiple criteria - analyze.py: Generate statistics, charts, and comparisons ## Enhanced Documentation - CONTRIBUTING.md: Comprehensive contribution guidelines - CHANGELOG.md: Version history and release notes - README.md: Complete reorganization with categories and search guide - scripts/README.md: Documentation for all automation tools ## Individual Tool READMEs - Anthropic/README.md: Claude models documentation - Cursor Prompts/README.md: Cursor AI system documentation - Open Source prompts/README.md: Open source tools overview ## Improved Organization - Reorganized tools by category (IDE, AI Agent, Code Assistant, etc.) - Added Quick Start section with usage examples - Added Search & Discovery section - Better categorization and navigation ## Features - Searchable metadata index (32 tools, 96 files, 20K+ lines) - Category-based browsing (11 categories) - Company and model filtering - Automated validation checks - Statistics and analysis tools - Comparison table generation ## Statistics - 32 AI tools documented - 96 total files (76 txt, 15 json, 5 md) - 20,045 lines of prompts and configuration - 11 distinct categories - 4 new Python scripts for automation Version: 2.0.0
231 lines
5.1 KiB
Markdown
231 lines
5.1 KiB
Markdown
# Repository Scripts
|
|
|
|
Automation and analysis tools for the AI tools prompt repository.
|
|
|
|
## 📋 Available Scripts
|
|
|
|
### 🔍 `generate_metadata.py`
|
|
Generates a comprehensive metadata index of all tools in the repository.
|
|
|
|
**Usage:**
|
|
```bash
|
|
python scripts/generate_metadata.py
|
|
```
|
|
|
|
**Output:**
|
|
- Creates `scripts/index.json` with complete tool metadata
|
|
- Shows statistics about tools, files, and line counts
|
|
- Categorizes tools by type, category, and company
|
|
|
|
**What it does:**
|
|
- Scans all directories for .txt, .json, and .md files
|
|
- Counts lines in text files
|
|
- Collects file sizes and metadata
|
|
- Organizes by predefined categories
|
|
- Generates searchable index
|
|
|
|
---
|
|
|
|
### ✅ `validate.py`
|
|
Validates repository structure and finds issues.
|
|
|
|
**Usage:**
|
|
```bash
|
|
python scripts/validate.py
|
|
```
|
|
|
|
**Checks performed:**
|
|
- ✓ README links point to valid directories
|
|
- ✓ All directories are listed in README
|
|
- ✓ No empty files exist
|
|
- ✓ File naming consistency
|
|
- ✓ Directory structure validity
|
|
|
|
**Exit codes:**
|
|
- `0` - All checks passed or only warnings
|
|
- `1` - Errors found
|
|
|
|
---
|
|
|
|
### 🔎 `search.py`
|
|
Search and filter tools by various criteria.
|
|
|
|
**Usage:**
|
|
```bash
|
|
# Search by category
|
|
python scripts/search.py --category "Code Assistant"
|
|
|
|
# Search by company
|
|
python scripts/search.py --company "Anthropic"
|
|
|
|
# Search by model
|
|
python scripts/search.py --model "gpt-5"
|
|
|
|
# Full-text search
|
|
python scripts/search.py --text "agent"
|
|
|
|
# Filter by type
|
|
python scripts/search.py --type "open-source"
|
|
|
|
# Verbose output
|
|
python scripts/search.py --category "IDE" --verbose
|
|
|
|
# List all categories
|
|
python scripts/search.py --list-categories
|
|
|
|
# List all companies
|
|
python scripts/search.py --list-companies
|
|
```
|
|
|
|
**Options:**
|
|
- `--category` - Filter by category (IDE, Code Assistant, etc.)
|
|
- `--company` - Filter by company name
|
|
- `--text` - Search in name and description
|
|
- `--model` - Filter by AI model used
|
|
- `--type` - Filter by type (proprietary/open-source)
|
|
- `--verbose, -v` - Show detailed information
|
|
- `--list-categories` - List all available categories
|
|
- `--list-companies` - List all companies
|
|
|
|
**Requirements:**
|
|
Run `generate_metadata.py` first to create the index.
|
|
|
|
---
|
|
|
|
### 📊 `analyze.py`
|
|
Generate comprehensive statistics and analysis.
|
|
|
|
**Usage:**
|
|
```bash
|
|
python scripts/analyze.py
|
|
```
|
|
|
|
**Analysis includes:**
|
|
- Overall repository statistics
|
|
- Tools by category (bar chart)
|
|
- Tools by company (bar chart)
|
|
- Tools by type (proprietary vs open-source)
|
|
- AI models usage
|
|
- Complexity analysis (by line count and file count)
|
|
- File size analysis
|
|
- Top 10 largest files
|
|
|
|
**Output:**
|
|
- Console output with colored charts
|
|
- `scripts/comparison_table.md` - Markdown comparison table
|
|
|
|
**Requirements:**
|
|
Run `generate_metadata.py` first to create the index.
|
|
|
|
---
|
|
|
|
## 🚀 Quick Start
|
|
|
|
**Complete analysis workflow:**
|
|
```bash
|
|
# 1. Generate metadata
|
|
python scripts/generate_metadata.py
|
|
|
|
# 2. Validate repository
|
|
python scripts/validate.py
|
|
|
|
# 3. View statistics
|
|
python scripts/analyze.py
|
|
|
|
# 4. Search for tools
|
|
python scripts/search.py --category "Code Assistant"
|
|
```
|
|
|
|
---
|
|
|
|
## 📁 Generated Files
|
|
|
|
Scripts generate the following files:
|
|
|
|
- `scripts/index.json` - Complete metadata index
|
|
- `scripts/comparison_table.md` - Markdown comparison table
|
|
|
|
These files are gitignored and regenerated on demand.
|
|
|
|
---
|
|
|
|
## 🔧 Technical Details
|
|
|
|
### Dependencies
|
|
All scripts use Python 3 standard library only. No external dependencies required.
|
|
|
|
### Python Version
|
|
Requires Python 3.6+
|
|
|
|
### File Structure
|
|
```
|
|
scripts/
|
|
├── README.md # This file
|
|
├── generate_metadata.py # Metadata generator
|
|
├── validate.py # Validation tool
|
|
├── search.py # Search tool
|
|
├── analyze.py # Analysis tool
|
|
├── index.json # Generated metadata (gitignored)
|
|
└── comparison_table.md # Generated comparison (gitignored)
|
|
```
|
|
|
|
### Adding New Tools to Metadata
|
|
|
|
To add metadata for new tools, edit `generate_metadata.py`:
|
|
|
|
```python
|
|
TOOL_INFO = {
|
|
"Tool Name": {
|
|
"name": "Display Name",
|
|
"company": "Company Name",
|
|
"category": "Code Assistant", # See categories below
|
|
"type": "proprietary", # or "open-source"
|
|
"description": "Brief description",
|
|
"website": "https://example.com",
|
|
"models": ["model-1", "model-2"]
|
|
}
|
|
}
|
|
```
|
|
|
|
**Categories:**
|
|
- `Code Assistant` - AI coding helpers
|
|
- `IDE` - Integrated development environments
|
|
- `AI Agent` - Autonomous agents
|
|
- `Web Builder` - UI/web generation tools
|
|
- `Terminal` - CLI-based tools
|
|
- `Cloud IDE` - Cloud development platforms
|
|
- `Document Assistant` - Documentation tools
|
|
- `Search Assistant` - Search/research tools
|
|
- `Foundation Model` - Base model prompts
|
|
|
|
---
|
|
|
|
## 🎨 Color Output
|
|
|
|
Scripts use ANSI color codes for better readability:
|
|
- 🔵 Blue - Headers and titles
|
|
- 🟢 Green - Success and data bars
|
|
- 🟡 Yellow - Warnings
|
|
- 🔴 Red - Errors
|
|
|
|
---
|
|
|
|
## 🤝 Contributing
|
|
|
|
To add new scripts:
|
|
1. Follow Python 3 standard library only (no external deps)
|
|
2. Add comprehensive docstrings
|
|
3. Update this README
|
|
4. Follow existing code style
|
|
5. Add usage examples
|
|
|
|
---
|
|
|
|
## 📄 License
|
|
|
|
Scripts are part of the main repository and follow the same license.
|
|
|
|
---
|
|
|
|
[← Back to main repository](../)
|