devskill 2.0.6 → 2.0.8

package/skills/php-mcp-server-generator/SKILL.md

@@ -0,0 +1,522 @@
+---
+name: php-mcp-server-generator
+description: 'Generate a complete PHP Model Context Protocol server project with tools, resources, prompts, and tests using the official PHP SDK'
+---
+
+# PHP MCP Server Generator
+
+You are a PHP MCP server generator. Create a complete, production-ready PHP MCP server project using the official PHP SDK.
+
+## Project Requirements
+
+Ask the user for:
+1. **Project name** (e.g., "my-mcp-server")
+2. **Server description** (e.g., "A file management MCP server")
+3. **Transport type** (stdio, http, or both)
+4. **Tools to include** (e.g., "file read", "file write", "list directory")
+5. **Whether to include resources and prompts**
+6. **PHP version** (8.2+ required)
+
+## Project Structure
+
+```
+{project-name}/
+├── composer.json
+├── .gitignore
+├── README.md
+├── server.php
+├── src/
+│   ├── Tools/
+│   │   └── {ToolClass}.php
+│   ├── Resources/
+│   │   └── {ResourceClass}.php
+│   ├── Prompts/
+│   │   └── {PromptClass}.php
+│   └── Providers/
+│       └── {CompletionProvider}.php
+└── tests/
+    └── ToolsTest.php
+```
+
+## File Templates
+
+### composer.json
+
+```json
+{
+    "name": "your-org/{project-name}",
+    "description": "{Server description}",
+    "type": "project",
+    "require": {
+        "php": "^8.2",
+        "mcp/sdk": "^0.1"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "^10.0",
+        "symfony/cache": "^6.4"
+    },
+    "autoload": {
+        "psr-4": {
+            "App\\\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Tests\\\\": "tests/"
+        }
+    },
+    "config": {
+        "optimize-autoloader": true,
+        "preferred-install": "dist",
+        "sort-packages": true
+    }
+}
+```
+
+### .gitignore
+
+```
+/vendor
+/cache
+composer.lock
+.phpunit.cache
+phpstan.neon
+```
+
+### README.md
+
+```markdown
+# {Project Name}
+
+{Server description}
+
+## Requirements
+
+- PHP 8.2 or higher
+- Composer
+
+## Installation
+
+```bash
+composer install
+```
+
+## Usage
+
+### Start Server (Stdio)
+
+```bash
+php server.php
+```
+
+### Configure in Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "{project-name}": {
+      "command": "php",
+      "args": ["/absolute/path/to/server.php"]
+    }
+  }
+}
+```
+
+## Testing
+
+```bash
+vendor/bin/phpunit
+```
+
+## Tools
+
+- **{tool_name}**: {Tool description}
+
+## Development
+
+Test with MCP Inspector:
+
+```bash
+npx @modelcontextprotocol/inspector php server.php
+```
+```
+
+### server.php
+
+```php
+#!/usr/bin/env php
+<?php
+
+declare(strict_types=1);
+
+require_once __DIR__ . '/vendor/autoload.php';
+
+use Mcp\Server;
+use Mcp\Server\Transport\StdioTransport;
+use Symfony\Component\Cache\Adapter\FilesystemAdapter;
+use Symfony\Component\Cache\Psr16Cache;
+
+// Setup cache for discovery
+$cache = new Psr16Cache(new FilesystemAdapter('mcp-discovery', 3600, __DIR__ . '/cache'));
+
+// Build server with discovery
+$server = Server::builder()
+    ->setServerInfo('{Project Name}', '1.0.0')
+    ->setDiscovery(
+        basePath: __DIR__,
+        scanDirs: ['src'],
+        excludeDirs: ['vendor', 'tests', 'cache'],
+        cache: $cache
+    )
+    ->build();
+
+// Run with stdio transport
+$transport = new StdioTransport();
+
+$server->run($transport);
+```
+
+### src/Tools/ExampleTool.php
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tools;
+
+use Mcp\Capability\Attribute\McpTool;
+use Mcp\Capability\Attribute\Schema;
+
+class ExampleTool
+{
+    /**
+     * Performs a greeting with the provided name.
+     * 
+     * @param string $name The name to greet
+     * @return string A greeting message
+     */
+    #[McpTool]
+    public function greet(string $name): string
+    {
+        return "Hello, {$name}!";
+    }
+    
+    /**
+     * Performs arithmetic calculations.
+     */
+    #[McpTool(name: 'calculate')]
+    public function performCalculation(
+        float $a,
+        float $b,
+        #[Schema(pattern: '^(add|subtract|multiply|divide)$')]
+        string $operation
+    ): float {
+        return match($operation) {
+            'add' => $a + $b,
+            'subtract' => $a - $b,
+            'multiply' => $a * $b,
+            'divide' => $b != 0 ? $a / $b : 
+                throw new \InvalidArgumentException('Division by zero'),
+            default => throw new \InvalidArgumentException('Invalid operation')
+        };
+    }
+}
+```
+
+### src/Resources/ConfigResource.php
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Resources;
+
+use Mcp\Capability\Attribute\McpResource;
+
+class ConfigResource
+{
+    /**
+     * Provides application configuration.
+     */
+    #[McpResource(
+        uri: 'config://app/settings',
+        name: 'app_config',
+        mimeType: 'application/json'
+    )]
+    public function getConfiguration(): array
+    {
+        return [
+            'version' => '1.0.0',
+            'environment' => 'production',
+            'features' => [
+                'logging' => true,
+                'caching' => true
+            ]
+        ];
+    }
+}
+```
+
+### src/Resources/DataProvider.php
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Resources;
+
+use Mcp\Capability\Attribute\McpResourceTemplate;
+
+class DataProvider
+{
+    /**
+     * Provides data by category and ID.
+     */
+    #[McpResourceTemplate(
+        uriTemplate: 'data://{category}/{id}',
+        name: 'data_resource',
+        mimeType: 'application/json'
+    )]
+    public function getData(string $category, string $id): array
+    {
+        // Example data retrieval
+        return [
+            'category' => $category,
+            'id' => $id,
+            'data' => "Sample data for {$category}/{$id}"
+        ];
+    }
+}
+```
+
+### src/Prompts/PromptGenerator.php
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Prompts;
+
+use Mcp\Capability\Attribute\McpPrompt;
+use Mcp\Capability\Attribute\CompletionProvider;
+
+class PromptGenerator
+{
+    /**
+     * Generates a code review prompt.
+     */
+    #[McpPrompt(name: 'code_review')]
+    public function reviewCode(
+        #[CompletionProvider(values: ['php', 'javascript', 'python', 'go', 'rust'])]
+        string $language,
+        string $code,
+        #[CompletionProvider(values: ['performance', 'security', 'style', 'general'])]
+        string $focus = 'general'
+    ): array {
+        return [
+            [
+                'role' => 'assistant',
+                'content' => 'You are an expert code reviewer specializing in best practices and optimization.'
+            ],
+            [
+                'role' => 'user',
+                'content' => "Review this {$language} code with focus on {$focus}:\n\n```{$language}\n{$code}\n```"
+            ]
+        ];
+    }
+    
+    /**
+     * Generates documentation prompt.
+     */
+    #[McpPrompt]
+    public function generateDocs(string $code, string $style = 'detailed'): array
+    {
+        return [
+            [
+                'role' => 'user',
+                'content' => "Generate {$style} documentation for:\n\n```\n{$code}\n```"
+            ]
+        ];
+    }
+}
+```
+
+### tests/ToolsTest.php
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace Tests;
+
+use PHPUnit\Framework\TestCase;
+use App\Tools\ExampleTool;
+
+class ToolsTest extends TestCase
+{
+    private ExampleTool $tool;
+    
+    protected function setUp(): void
+    {
+        $this->tool = new ExampleTool();
+    }
+    
+    public function testGreet(): void
+    {
+        $result = $this->tool->greet('World');
+        $this->assertSame('Hello, World!', $result);
+    }
+    
+    public function testCalculateAdd(): void
+    {
+        $result = $this->tool->performCalculation(5, 3, 'add');
+        $this->assertSame(8.0, $result);
+    }
+    
+    public function testCalculateDivide(): void
+    {
+        $result = $this->tool->performCalculation(10, 2, 'divide');
+        $this->assertSame(5.0, $result);
+    }
+    
+    public function testCalculateDivideByZero(): void
+    {
+        $this->expectException(\InvalidArgumentException::class);
+        $this->expectExceptionMessage('Division by zero');
+        
+        $this->tool->performCalculation(10, 0, 'divide');
+    }
+    
+    public function testCalculateInvalidOperation(): void
+    {
+        $this->expectException(\InvalidArgumentException::class);
+        $this->expectExceptionMessage('Invalid operation');
+        
+        $this->tool->performCalculation(5, 3, 'modulo');
+    }
+}
+```
+
+### phpunit.xml.dist
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:noNamespaceSchemaLocation="vendor/phpunit/phpunit/phpunit.xsd"
+         bootstrap="vendor/autoload.php"
+         colors="true">
+    <testsuites>
+        <testsuite name="Test Suite">
+            <directory>tests</directory>
+        </testsuite>
+    </testsuites>
+    <coverage>
+        <include>
+            <directory suffix=".php">src</directory>
+        </include>
+    </coverage>
+</phpunit>
+```
+
+## Implementation Guidelines
+
+1. **Use PHP Attributes**: Leverage `#[McpTool]`, `#[McpResource]`, `#[McpPrompt]` for clean code
+2. **Type Declarations**: Use strict types (`declare(strict_types=1);`) in all files
+3. **PSR-12 Coding Standard**: Follow PHP-FIG standards
+4. **Schema Validation**: Use `#[Schema]` attributes for parameter validation
+5. **Error Handling**: Throw specific exceptions with clear messages
+6. **Testing**: Write PHPUnit tests for all tools
+7. **Documentation**: Use PHPDoc blocks for all methods
+8. **Caching**: Always use PSR-16 cache for discovery in production
+
+## Tool Patterns
+
+### Simple Tool
+```php
+#[McpTool]
+public function simpleAction(string $input): string
+{
+    return "Processed: {$input}";
+}
+```
+
+### Tool with Validation
+```php
+#[McpTool]
+public function validateEmail(
+    #[Schema(format: 'email')]
+    string $email
+): bool {
+    return filter_var($email, FILTER_VALIDATE_EMAIL) !== false;
+}
+```
+
+### Tool with Enum
+```php
+enum Status: string {
+    case ACTIVE = 'active';
+    case INACTIVE = 'inactive';
+}
+
+#[McpTool]
+public function setStatus(string $id, Status $status): array
+{
+    return ['id' => $id, 'status' => $status->value];
+}
+```
+
+## Resource Patterns
+
+### Static Resource
+```php
+#[McpResource(uri: 'config://settings', mimeType: 'application/json')]
+public function getSettings(): array
+{
+    return ['key' => 'value'];
+}
+```
+
+### Dynamic Resource
+```php
+#[McpResourceTemplate(uriTemplate: 'user://{id}')]
+public function getUser(string $id): array
+{
+    return $this->users[$id] ?? throw new \RuntimeException('User not found');
+}
+```
+
+## Running the Server
+
+```bash
+# Install dependencies
+composer install
+
+# Run tests
+vendor/bin/phpunit
+
+# Start server
+php server.php
+
+# Test with inspector
+npx @modelcontextprotocol/inspector php server.php
+```
+
+## Claude Desktop Configuration
+
+```json
+{
+  "mcpServers": {
+    "{project-name}": {
+      "command": "php",
+      "args": ["/absolute/path/to/server.php"]
+    }
+  }
+}
+```
+
+Now generate the complete project based on user requirements!

package/skills/php-mcp-server-generator/SYNC.md

@@ -0,0 +1,5 @@
+# Sync Info
+
+- **Source:** `vendor/awesome-copilot/skills/php-mcp-server-generator`
+- **Git SHA:** `23fb7006c132a0bba75b0e5af7a35cab11272812`
+- **Synced:** 2026-03-24

package/skills/planning-oracle-to-postgres-migration-integration-testing/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright GitHub, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/planning-oracle-to-postgres-migration-integration-testing/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: planning-oracle-to-postgres-migration-integration-testing
+description: 'Creates an integration testing plan for .NET data access artifacts during Oracle-to-PostgreSQL database migrations. Analyzes a single project to identify repositories, DAOs, and service layers that interact with the database, then produces a structured testing plan. Use when planning integration test coverage for a migrated project, identifying which data access methods need tests, or preparing for Oracle-to-PostgreSQL migration validation.'
+---
+
+# Planning Integration Testing for Oracle-to-PostgreSQL Migration
+
+Analyze a single target project to identify data access artifacts that require integration testing, then produce a structured, actionable testing plan.
+
+## Workflow
+
+```
+Progress:
+- [ ] Step 1: Identify data access artifacts
+- [ ] Step 2: Classify testing priorities
+- [ ] Step 3: Write the testing plan
+```
+
+**Step 1: Identify data access artifacts**
+
+Scope to the target project only. Find classes and methods that interact directly with the database — repositories, DAOs, stored procedure callers, service layers performing CRUD operations.
+
+**Step 2: Classify testing priorities**
+
+Rank artifacts by migration risk. Prioritize methods that use Oracle-specific features (refcursors, `TO_CHAR`, implicit type coercion, `NO_DATA_FOUND`) over simple CRUD.
+
+**Step 3: Write the testing plan**
+
+Write a markdown plan covering:
+- List of testable artifacts with method signatures
+- Recommended test cases per artifact
+- Seed data requirements
+- Known Oracle→PostgreSQL behavioral differences to validate
+
+## Output
+
+Write the plan to: `.github/oracle-to-postgres-migration/Reports/{TARGET_PROJECT} Integration Testing Plan.md`
+
+## Key Constraints
+
+- **Single project scope** — only plan tests for artifacts within the target project.
+- **Database interactions only** — skip business logic that does not touch the database.
+- **Oracle is the golden source** — tests should capture Oracle's expected behavior for comparison against PostgreSQL.
+- **No multi-connection harnessing** — migrated applications are copied and renamed (e.g., `MyApp.Postgres`), so each instance targets one database.

package/skills/planning-oracle-to-postgres-migration-integration-testing/SYNC.md

@@ -0,0 +1,5 @@
+# Sync Info
+
+- **Source:** `vendor/awesome-copilot/skills/planning-oracle-to-postgres-migration-integration-testing`
+- **Git SHA:** `23fb7006c132a0bba75b0e5af7a35cab11272812`
+- **Synced:** 2026-03-24

package/skills/plantuml-ascii/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright GitHub, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.