Arda Skills

A collection of Claude skills for agents across the Arda ecosystem. These skills provide specialized capabilities for credit market analysis, document research, knowledge graph analysis, and MCP server development.

What are Claude Skills?

Claude skills are reusable, specialized capabilities that extend Claude's functionality. They enable agents to perform specific tasks through well-documented guides and reference materials. Skills in this repository are instructional guides that help Claude understand how to use various tools and capabilities effectively.

Repository Structure

arda-skills/
├── README.md
├── SETUP.md              # Setup and installation guide
├── Makefile              # Installation automation
├── template/
│   └── SKILL.md          # Template for creating new skills
└── skills/
    ├── skill-name/
    │   ├── SKILL.md      # Main skill guide
    │   ├── LICENSE.txt   # License information
    │   └── reference/    # Reference documentation
    │       └── ...
    └── ...

Available Skills

📚 MCP Builder

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools.

• Location: skills/mcp-builder/
• Use When: Building MCP servers to integrate external APIs or services
• Key Features:
  • Complete workflow for MCP server development
  • TypeScript and Python implementation guides
  • Evaluation framework for testing MCP servers
  • Best practices and patterns

Reference Documentation:

• MCP Best Practices
• TypeScript Implementation Guide
• Python Implementation Guide
• Evaluation Guide

🔍 Document Semantic Search

Semantic search across credit documentation using 4096-dimensional embeddings (Qwen3-Embedding-8B). Enables natural language queries to find relevant clauses, covenants, terms, and structures.

• Location: skills/document-semantic-search/
• Use When: Searching credit documentation, researching precedents, extracting covenant structures, or analyzing collateral packages
• Key Features:
  • Natural language semantic search
  • Document type recognition and categorization
  • Covenant and collateral extraction
  • Metadata filtering and query optimization

Reference Documentation:

• Query Optimization Guide
• Document Preparation Guide
• Best Practices Guide

🕸️ Knowledge Graph Research

Deep discourse analysis of credit market documents using InfraNodus text network analysis. Transforms document collections into knowledge graphs, revealing conceptual relationships, thematic clusters, and structural gaps.

• Location: skills/knowledge-graph-research/
• Use When: Analyzing credit documentation, developing investment theses, conducting due diligence, or synthesizing market intelligence
• Key Features:
  • Text network analysis and knowledge graph construction
  • Discourse gap detection
  • Concept clustering and thematic analysis
  • Graph-based AI insights (Graph-RAG)
  • Visual graph generation

Reference Documentation:

• Document Preparation Guide
• Graph Analysis Guide
• Best Practices Guide

Skill Format

Each skill follows a consistent structure:

1. SKILL.md: Main skill guide with:

   • Overview and core capabilities
   • Process/workflow phases
   • Reference section with key functions
   • Integration examples
   • Reference files section

2. LICENSE.txt: License information (Apache 2.0)

3. reference/: Supplementary documentation:

   • Detailed guides for specific aspects
   • Best practices
   • Advanced techniques
   • Troubleshooting

Installation

Quick Setup

1. Clone the repository:

   git clone <repository-url>
   cd arda-skills

2. Install skills:

   make install

3. Verify installation:

   make check

For detailed setup instructions, see SETUP.md.

Available Make Commands

• make install - Install all skills to Claude skills directory
• make uninstall - Remove all installed skills
• make check - Check current setup and installed skills
• make list - List all available skills with descriptions
• make update - Update installed skills (reinstall)
• make help - Show help message

Using Skills

Skills are designed to be loaded by Claude when needed. Each skill's SKILL.md file contains:

• Frontmatter: Metadata (name, description, license)
• Process Section: Step-by-step workflows organized by phases
• Reference Section: Detailed technical documentation
• Reference Files: Links to supplementary guides

Claude can load these skills to understand how to:

• Use specific tools and capabilities
• Follow best practices
• Execute complex workflows
• Integrate with other skills

Creating New Skills

To create a new skill:

1. Use the Template: Start with template/SKILL.md as a base
2. Create Skill Directory: Create skills/your-skill-name/
3. Add Required Files:
   • SKILL.md - Main skill guide following the standard format
   • LICENSE.txt - License file (copy from existing skill)
4. Add Reference Documentation (optional):
   • Create reference/ folder
   • Add detailed guides as needed
5. Follow the Format: Match the structure of existing skills:
   • Frontmatter with metadata
   • Process section with phases
   • Reference section with technical details
   • Reference files section

Skill Development Guidelines

• Clear Structure: Follow the phase-based process format
• Comprehensive Documentation: Include examples, use cases, and workflows
• Reference Materials: Create detailed guides for complex topics
• Integration Examples: Show how skills work together
• Best Practices: Include troubleshooting and quality guidelines

Integration

Skills are designed to work together:

• Document Semantic Search + Knowledge Graph Research: Use semantic search to find documents, then build knowledge graphs from results
• Knowledge Graph Research + SEC Intelligence: Analyze SEC filings using discourse analysis
• MCP Builder: Create MCP servers that expose capabilities used by other skills

Documentation

• SETUP.md - Complete setup and installation guide with troubleshooting
• Claude Code Documentation
• Claude Agent SDK
• Building Custom Skills

License

All skills are licensed under the Apache License 2.0. See individual LICENSE.txt files in each skill directory for complete terms.

Support

For issues or questions about specific skills:

• Review the skill's SKILL.md and reference documentation
• Check the skill's reference/ folder for detailed guides
• Open an issue in this repository

Contributing

When contributing new skills or improvements:

1. Follow the established format and structure
2. Include comprehensive documentation
3. Add reference guides for complex topics
4. Provide examples and use cases
5. Test thoroughly before submitting
6. Submit a pull request with a clear description

---

Last Updated: 2025-01-06