fix: address all PR #320 review feedback

- Added YAML frontmatter with project and service information
- Changed GitHub links to be primary (instead of PyPI first)
- Added service provider links (Deepgram, HubSpot, Teams, Telegram)
- Removed Strands SDK links (redundant in docs)
- Fixed environment variable alignment with proper comments
- Updated HubSpot link to working developer docs URL
- Added strands-tools-community meta-package references
- Fixed all issues raised by zastrowm in PR review

Author: eraykeskinmac

docs/community/tools/strands-deepgram.md

@@ -1,8 +1,20 @@
+---
+project:
+  pypi: https://pypi.org/project/strands-deepgram/
+  github: https://github.com/eraykeskinmac/strands-deepgram
+  maintainer: eraykeskinmac
+service:
+  name: deepgram
+  link: https://console.deepgram.com/
+---
+
 # strands-deepgram
 
 {{ community_contribution_banner }}
 
-[strands-deepgram](https://pypi.org/project/strands-deepgram/) is a production-ready speech and audio processing tool for [Strands Agents SDK](https://github.com/strands-agents/sdk-python), powered by Deepgram's AI platform with 30+ language support.
+[strands-deepgram](https://github.com/eraykeskinmac/strands-deepgram) is a production-ready speech and audio processing tool powered by [Deepgram's AI platform](https://deepgram.com/) with 30+ language support.
+
+> **Alternative Installation**: Also available as part of the [strands-tools-community](https://github.com/eraykeskinmac/strands-tools-community) meta-package for convenient multi-tool installation.
 
 ## Installation
 
@@ -40,14 +52,15 @@ agent("analyze sentiment in call.wav")
 ## Configuration
 
 ```bash
-DEEPGRAM_API_KEY=your_deepgram_api_key  # Required
-DEEPGRAM_DEFAULT_MODEL=nova-3            # Optional
-DEEPGRAM_DEFAULT_LANGUAGE=en             # Optional
+DEEPGRAM_API_KEY=your_deepgram_api_key    # Required
+DEEPGRAM_DEFAULT_MODEL=nova-3             # Optional
+DEEPGRAM_DEFAULT_LANGUAGE=en              # Optional
 ```
 
 Get your API key at: [console.deepgram.com](https://console.deepgram.com/)
 
 ## Resources
 
-- **PyPI**: [pypi.org/project/strands-deepgram](https://pypi.org/project/strands-deepgram/)
-- **GitHub**: [github.com/eraykeskinmac/strands-deepgram](https://github.com/eraykeskinmac/strands-deepgram)
+- **PyPI Package**: https://pypi.org/project/strands-deepgram/
+- **GitHub Repository**: https://github.com/eraykeskinmac/strands-deepgram
+- **Deepgram API**: https://console.deepgram.com/

docs/community/tools/strands-hubspot.md

@@ -1,11 +1,23 @@
+---
+project:
+  pypi: https://pypi.org/project/strands-hubspot/
+  github: https://github.com/eraykeskinmac/strands-hubspot
+  maintainer: eraykeskinmac
+service:
+  name: hubspot
+  link: https://developers.hubspot.com/
+---
+
 # strands-hubspot
 
 {{ community_contribution_banner }}
 
-[strands-hubspot](https://pypi.org/project/strands-hubspot/) is a production-ready HubSpot CRM tool for [Strands Agents SDK](https://github.com/strands-agents/sdk-python), designed for **READ-ONLY** operations with zero risk of data modification. It enables agents to safely access and analyze CRM data without any possibility of corrupting customer information.
+[strands-hubspot](https://github.com/eraykeskinmac/strands-hubspot) is a production-ready HubSpot CRM tool designed for **READ-ONLY** operations with zero risk of data modification. It enables agents to safely access and analyze CRM data without any possibility of corrupting customer information.
 
 This community tool provides comprehensive HubSpot integration for AI agents, offering safe CRM data access for sales intelligence, customer research, and data analytics workflows.
 
+> **Alternative Installation**: Also available as part of the [strands-tools-community](https://github.com/eraykeskinmac/strands-tools-community) meta-package for convenient multi-tool installation.
+
 ## Installation
 
 ```bash
@@ -51,23 +63,14 @@ agent("search for deals with amount greater than 10000")
 Set your HubSpot API key as an environment variable:
 
 ```bash
-HUBSPOT_API_KEY=your_hubspot_api_key  # Required
-HUBSPOT_DEFAULT_LIMIT=100              # Optional
+HUBSPOT_API_KEY=your_hubspot_api_key      # Required
+HUBSPOT_DEFAULT_LIMIT=100                 # Optional
 ```
 
-Get your API key at: [app.hubspot.com/private-apps](https://app.hubspot.com/private-apps)
-
-## Use Cases
-
-- **Analytics & Reporting**: Generate insights from CRM data
-- **Customer Research**: Search and analyze customer information
-- **Data Discovery**: Explore available properties and data structure
-- **AI-Powered Insights**: Let agents analyze CRM data safely
-- **Sales Intelligence**: Extract trends and patterns from deals/contacts
-- **Lead Analysis**: Research prospects and opportunities
+Get your API key at: [HubSpot Private Apps](https://developers.hubspot.com/docs/api/private-apps)
 
 ## Resources
 
-- **PyPI**: [pypi.org/project/strands-hubspot](https://pypi.org/project/strands-hubspot/)
-- **GitHub**: [github.com/eraykeskinmac/strands-hubspot](https://github.com/eraykeskinmac/strands-hubspot)
-- **Examples**: [github.com/eraykeskinmac/strands-tools-examples](https://github.com/eraykeskinmac/strands-tools-examples)
+- **PyPI Package**: https://pypi.org/project/strands-hubspot/
+- **GitHub Repository**: https://github.com/eraykeskinmac/strands-hubspot
+- **HubSpot API Docs**: https://developers.hubspot.com/

docs/community/tools/strands-teams.md

@@ -1,8 +1,20 @@
+---
+project:
+  pypi: https://pypi.org/project/strands-teams/
+  github: https://github.com/eraykeskinmac/strands-teams
+  maintainer: eraykeskinmac
+service:
+  name: microsoft-teams
+  link: https://teams.microsoft.com/
+---
+
 # strands-teams
 
 {{ community_contribution_banner }}
 
-[strands-teams](https://pypi.org/project/strands-teams/) is a production-ready Microsoft Teams notifications tool for [Strands Agents SDK](https://github.com/strands-agents/sdk-python), powered by Adaptive Cards and rich messaging capabilities.
+[strands-teams](https://github.com/eraykeskinmac/strands-teams) is a production-ready Microsoft Teams notification tool with rich Adaptive Cards support and custom messaging capabilities.
+
+> **Alternative Installation**: Also available as part of the [strands-tools-community](https://github.com/eraykeskinmac/strands-tools-community) meta-package for convenient multi-tool installation.
 
 ## Installation
 
@@ -18,31 +30,36 @@ from strands_teams import teams
 
 agent = Agent(tools=[teams])
 
-# Simple notification  
+# Simple notification
 agent("send a Teams message: New lead from Acme Corp")
 
-# Pre-built templates
-agent("send an approval request to Teams for the Q4 budget")
+# Status update with formatting
+agent("send a status update: Website redesign is 75% complete")
 
-# Status updates
-agent("send status update: website redesign is 75% complete")
+# Custom adaptive card
+agent("create approval request for Q4 budget with amount $50000")
 ```
 
 ## Key Features
 
 - **Adaptive Cards**: Rich, interactive message cards with modern UI
-- **Pre-built Templates**: Notifications, approvals, status updates, and more
-- **Action Buttons**: Interactive elements like approve/reject buttons
-- **Rich Formatting**: Markdown support, images, and color coding
-- **Type Safe**: Full type hints and validation
+- **Pre-built Templates**: Notifications, approvals, status updates, and alerts
+- **Custom Cards**: Full adaptive card schema support for complex layouts
+- **Action Buttons**: Add interactive elements and quick actions
+- **Rich Formatting**: Markdown support, images, tables, and media
+- **Webhook Integration**: Seamless Teams channel integration
 
 ## Configuration
 
 ```bash
-TEAMS_WEBHOOK_URL=your_webhook_url  # Optional
+TEAMS_WEBHOOK_URL=your_teams_webhook_url  # Optional (can be provided per call)
 ```
 
+Setup webhook: Teams Channel → Connectors → Incoming Webhook
+
 ## Resources
 
-- **PyPI**: [pypi.org/project/strands-teams](https://pypi.org/project/strands-teams/)
-- **GitHub**: [github.com/eraykeskinmac/strands-teams](https://github.com/eraykeskinmac/strands-teams)
+- **PyPI Package**: https://pypi.org/project/strands-teams/
+- **GitHub Repository**: https://github.com/eraykeskinmac/strands-teams
+- **Adaptive Cards**: https://adaptivecards.io/
+- **Teams Webhooks**: https://docs.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/

docs/community/tools/strands-telegram-listener.md

@@ -1,14 +1,25 @@
+---
+project:
+  pypi: https://pypi.org/project/strands-telegram-listener/
+  github: https://github.com/eraykeskinmac/strands-telegram-listener
+  maintainer: eraykeskinmac
+service:
+  name: telegram
+  link: https://core.telegram.org/bots
+---
+
 # strands-telegram-listener
 
 {{ community_contribution_banner }}
 
-[strands-telegram-listener](https://pypi.org/project/strands-telegram-listener/) is a production-ready real-time Telegram message processing tool for [Strands Agents SDK](https://github.com/strands-agents/sdk-python) with AI-powered auto-responses and background monitoring.
+[strands-telegram-listener](https://github.com/eraykeskinmac/strands-telegram-listener) is a real-time Telegram message processing tool with AI-powered auto-replies and comprehensive event handling.
+
+> **Alternative Installation**: Also available as part of the [strands-tools-community](https://github.com/eraykeskinmac/strands-tools-community) meta-package for convenient multi-tool installation.
 
 ## Installation
 
 ```bash
 pip install strands-telegram-listener
-pip install strands-telegram  # Companion package
 ```
 
 ## Usage
@@ -20,33 +31,38 @@ from strands_telegram_listener import telegram_listener
 agent = Agent(tools=[telegram_listener])
 
 # Start listening for messages
-agent("start listening to Telegram messages and respond with AI")
+agent("start Telegram listener")
 
-# Get recent message history
-agent("show me the last 10 Telegram messages received")
+# Get recent messages
+agent("get last 10 Telegram messages")
 
 # Check listener status
-agent("what's the status of the Telegram listener?")
+agent("check Telegram listener status")
 ```
 
 ## Key Features
 
-- **Real-time Processing**: Long polling for instant message processing
-- **AI Auto-Replies**: Intelligent responses powered by Strands agents
-- **Event Storage**: Comprehensive message logging and history (JSONL format)
-- **Smart Filtering**: Message deduplication and own message filtering
-- **Configurable**: Environment variable control for auto-reply behavior
-- **Background Processing**: Non-blocking operation with thread safety
+- **Real-time Processing**: Long polling for instant message handling
+- **AI Auto-replies**: Intelligent responses using Strands agents
+- **Event Storage**: Comprehensive message history in JSONL format
+- **Smart Filtering**: Message deduplication and selective processing
+- **Background Threading**: Non-blocking operation
+- **Status Monitoring**: Real-time listener status and metrics
+- **Flexible Configuration**: Environment-based settings
 
 ## Configuration
 
 ```bash
-TELEGRAM_BOT_TOKEN=your_bot_token                # Required
-STRANDS_TELEGRAM_AUTO_REPLY=true                 # Optional
-STRANDS_TELEGRAM_LISTEN_ONLY_TAG="#support"      # Optional
+TELEGRAM_BOT_TOKEN=your_bot_token         # Required
+STRANDS_TELEGRAM_AUTO_REPLY=true          # Optional
+STRANDS_TELEGRAM_LISTEN_ONLY_TAG=#support # Optional
 ```
 
+Get your bot token at: [BotFather](https://core.telegram.org/bots#botfather)
+
 ## Resources
 
-- **PyPI**: [pypi.org/project/strands-telegram-listener](https://pypi.org/project/strands-telegram-listener/)
-- **GitHub**: [github.com/eraykeskinmac/strands-telegram-listener](https://github.com/eraykeskinmac/strands-telegram-listener)
+- **PyPI Package**: https://pypi.org/project/strands-telegram-listener/
+- **GitHub Repository**: https://github.com/eraykeskinmac/strands-telegram-listener
+- **Bot Creation Guide**: https://core.telegram.org/bots
+- **Telegram Bot API**: https://core.telegram.org/bots/api

docs/community/tools/strands-telegram.md

@@ -1,8 +1,20 @@
+---
+project:
+  pypi: https://pypi.org/project/strands-telegram/
+  github: https://github.com/eraykeskinmac/strands-telegram
+  maintainer: eraykeskinmac
+service:
+  name: telegram
+  link: https://core.telegram.org/bots
+---
+
 # strands-telegram
 
 {{ community_contribution_banner }}
 
-[strands-telegram](https://pypi.org/project/strands-telegram/) is a production-ready, comprehensive Telegram Bot API integration for [Strands Agents SDK](https://github.com/strands-agents/sdk-python) with 60+ methods and complete API coverage.
+[strands-telegram](https://github.com/eraykeskinmac/strands-telegram) is a comprehensive Telegram Bot API integration tool with 60+ methods for complete bot development capabilities.
+
+> **Alternative Installation**: Also available as part of the [strands-tools-community](https://github.com/eraykeskinmac/strands-tools-community) meta-package for convenient multi-tool installation.
 
 ## Installation
 
@@ -18,32 +30,37 @@ from strands_telegram import telegram
 
 agent = Agent(tools=[telegram])
 
-# Send messages
-agent("send a Telegram message to @username: Hello from AI agent!")
+# Send simple message
+agent("send a Telegram message 'Hello World' to chat 123456")
 
-# Interactive keyboards
-agent("send a poll to Telegram: What's your favorite color? Red, Blue, Green")
+# Send media with caption
+agent("send photo.jpg to Telegram with caption 'Check this out!'")
 
-# Media sharing
-agent("send this image to Telegram with caption: image.jpg")
+# Create interactive keyboard
+agent("send a message with buttons: Yes/No for approval")
 ```
 
 ## Key Features
 
-- **Complete Bot API**: 60+ Telegram API methods (messages, media, keyboards, polls, groups)
-- **Interactive Elements**: Inline keyboards, polls, dice games, location sharing
-- **Group Management**: Admin tools, user management, permissions control
-- **Media Support**: Photos, videos, documents, audio, stickers, voice messages
-- **Webhooks**: Full webhook support for real-time message processing
-- **Custom API Calls**: Extensible for any Telegram Bot API method
+- **60+ Telegram API Methods**: Complete Bot API coverage
+- **Media Support**: Photos, videos, audio, documents, and stickers
+- **Interactive Elements**: Inline keyboards, polls, dice games
+- **Group Management**: Admin functions, member management, permissions
+- **File Operations**: Upload, download, and media handling
+- **Webhook Support**: Real-time message processing
+- **Custom API Calls**: Extensible for any Telegram method
 
 ## Configuration
 
 ```bash
-TELEGRAM_BOT_TOKEN=your_bot_token  # Required from @BotFather
+TELEGRAM_BOT_TOKEN=your_bot_token         # Required
 ```
 
+Get your bot token at: [BotFather](https://core.telegram.org/bots#botfather)
+
 ## Resources
 
-- **PyPI**: [pypi.org/project/strands-telegram](https://pypi.org/project/strands-telegram/)
-- **GitHub**: [github.com/eraykeskinmac/strands-telegram](https://github.com/eraykeskinmac/strands-telegram)
+- **PyPI Package**: https://pypi.org/project/strands-telegram/
+- **GitHub Repository**: https://github.com/eraykeskinmac/strands-telegram
+- **Bot Creation Guide**: https://core.telegram.org/bots
+- **Telegram Bot API**: https://core.telegram.org/bots/api