Initial commit

skills/web-to-github-issue/assets/README.md

@@ -0,0 +1,7 @@
+# Assets
+
+Bundled resources for web-to-github-issue skill
+
+- [ ] issue_template.md: Markdown template for generating GitHub issues with predefined sections and formatting.
+- [ ] example_search_results.json: Example JSON data representing web search results, used for testing and demonstration purposes.
+- [ ] config_template.json: Template for the configuration file, including placeholders for API keys and other settings.

skills/web-to-github-issue/assets/config_template.json

@@ -0,0 +1,59 @@
+{
+  "_comment": "Configuration template for the web-to-github-issue plugin.",
+  "plugin_name": "web-to-github-issue",
+  "github": {
+    "_comment": "GitHub API settings",
+    "api_url": "https://api.github.com",
+    "owner": "your-github-username",
+    "repo": "your-github-repo",
+    "api_token": "YOUR_GITHUB_API_TOKEN",
+    "_comment": "Token with 'repo' scope is required.",
+    "default_labels": [
+      "claude-generated",
+      "web-research"
+    ],
+    "_comment": "Default labels to apply to created issues. Can be overridden in the prompt.",
+    "default_assignees": [
+      "your-github-username"
+    ],
+    "_comment": "Default assignees for created issues. Can be overridden in the prompt."
+  },
+  "issue_template": {
+    "_comment": "Template for the issue body.  Use placeholders like {{title}}, {{summary}}, {{url}}.",
+    "title": "Research Finding: {{title}}",
+    "body": "## Summary\n{{summary}}\n\n## Source URL\n{{url}}\n\n---\nThis issue was automatically generated by Claude based on web research."
+  },
+  "web_search": {
+    "_comment": "Settings related to web search and content extraction.",
+    "max_summary_length": 500,
+    "_comment": "Maximum length of the summary extracted from the web page (characters).",
+    "content_selector": "article, main, .content",
+    "_comment": "CSS selectors to extract main content from the webpage.  Try different selectors to improve results.",
+    "request_timeout": 15,
+    "_comment": "Timeout for web requests in seconds."
+  },
+  "error_handling": {
+    "_comment": "Settings for handling errors during issue creation.",
+    "log_errors": true,
+    "_comment": "Whether to log errors to a file or console.",
+    "error_notification_channel": null,
+    "_comment": "Optional Slack channel or email address to send error notifications to."
+  },
+  "rate_limiting": {
+    "_comment": "Settings to prevent exceeding GitHub API rate limits.",
+    "requests_per_minute": 30,
+    "_comment": "Maximum number of requests to GitHub API per minute.",
+    "retry_on_rate_limit": true,
+    "_comment": "Whether to retry requests if rate limited."
+  },
+  "security": {
+    "_comment": "Security configurations to protect sensitive information.",
+    "sanitize_html": true,
+    "_comment": "Whether to sanitize HTML content before including it in the issue body.",
+    "allowed_domains": [
+      "example.com",
+      "github.com"
+    ],
+    "_comment": "List of allowed domains to fetch content from.  Prevents fetching content from untrusted sources."
+  }
+}

skills/web-to-github-issue/assets/example_search_results.json

@@ -0,0 +1,61 @@
+{
+  "_comment": "Example JSON data representing web search results for the web-to-github-issue plugin.",
+  "query": "CVE-2023-45678 vulnerability analysis",
+  "results": [
+    {
+      "_comment": "First search result",
+      "title": "Detailed Analysis of CVE-2023-45678: Critical Vulnerability in OpenSSL",
+      "url": "https://example.com/cve-2023-45678-analysis",
+      "snippet": "This article provides a comprehensive analysis of CVE-2023-45678, a critical vulnerability affecting OpenSSL versions 1.1.1 and 3.0.x. It details the vulnerability's impact, affected systems, and potential remediation steps. Includes proof-of-concept exploit code.",
+      "metadata": {
+        "source": "Security Blog",
+        "date": "2023-11-15"
+      },
+      "relevance_score": 0.95
+    },
+    {
+      "_comment": "Second search result",
+      "title": "NIST NVD - CVE-2023-45678",
+      "url": "https://nvd.nist.gov/vuln/detail/CVE-2023-45678",
+      "snippet": "NIST's National Vulnerability Database entry for CVE-2023-45678. Provides a description of the vulnerability, affected software, and CVSS score.",
+      "metadata": {
+        "source": "NIST",
+        "date": "2023-11-10"
+      },
+      "relevance_score": 0.90
+    },
+    {
+      "_comment": "Third search result",
+      "title": "GitHub Repository: Proof-of-Concept Exploit for CVE-2023-45678",
+      "url": "https://github.com/exploits/cve-2023-45678",
+      "snippet": "A public GitHub repository containing a proof-of-concept exploit for CVE-2023-45678. Use with caution.",
+      "metadata": {
+        "source": "GitHub",
+        "date": "2023-11-12"
+      },
+      "relevance_score": 0.85
+    },
+    {
+      "_comment": "Fourth search result",
+      "title": "OpenSSL Security Advisory - CVE-2023-45678",
+      "url": "https://openssl.org/news/secadv/20231108.txt",
+      "snippet": "Official security advisory from OpenSSL regarding CVE-2023-45678. Includes information on affected versions and remediation.",
+      "metadata": {
+        "source": "OpenSSL",
+        "date": "2023-11-08"
+      },
+      "relevance_score": 0.92
+    },
+    {
+      "_comment": "Fifth search result - less relevant",
+      "title": "Discussion Forum on OpenSSL Security",
+      "url": "https://example.com/forum/openssl-security",
+      "snippet": "A general discussion forum about OpenSSL security topics. Mentions recent vulnerabilities.",
+      "metadata": {
+        "source": "Security Forum",
+        "date": "2023-11-16"
+      },
+      "relevance_score": 0.60
+    }
+  ]
+}

skills/web-to-github-issue/assets/issue_template.md

@@ -0,0 +1,69 @@
+# GitHub Issue: Web Research Findings
+
+This issue was automatically generated from web research conducted by Claude. Please review and fill in the missing details.
+
+## Summary
+
+[**Briefly summarize the issue here. What problem does this issue address? What is the desired outcome?**]
+
+*Example: "Improve website loading speed by optimizing image sizes."*
+
+## Web Research Context
+
+[**Paste the relevant context from the web research conducted by Claude. This might include snippets of text, links to specific pages, or summaries of research findings.**]
+
+*Example:*
+
+>*"According to [website link], large image files are a common cause of slow loading times. The website recommends using optimized image formats like WebP and compressing images before uploading."*
+
+>*"Google's PageSpeed Insights tool ([link to PageSpeed Insights]) reports that our website's images are not optimized and contribute significantly to the overall loading time."*
+
+## Proposed Solution
+
+[**Describe the proposed solution based on the web research. Be specific and actionable.**]
+
+*Example: "Implement image optimization techniques, including converting images to WebP format, compressing images using tools like ImageOptim, and using responsive images to serve appropriately sized images for different devices."*
+
+## Steps to Reproduce
+
+[**If applicable, provide steps to reproduce the problem or verify the solution.**]
+
+*Example:*
+
+1.  *Visit the website [website link] on a mobile device.*
+2.  *Observe the loading time of the page.*
+3.  *Compare the loading time before and after implementing image optimization techniques.*
+
+## Acceptance Criteria
+
+[**Define the criteria that must be met for the issue to be considered resolved.**]
+
+*Example:*
+
+*   *Website loading time (as measured by Google PageSpeed Insights) is reduced by at least 20%.*
+*   *Images are optimized for web and mobile devices without significant loss of quality.*
+*   *WebP format is used for all new images uploaded to the website.*
+
+## Relevant URLs
+
+[**List any relevant URLs that are related to the issue or the proposed solution.**]
+
+*Example:*
+
+*   *[Website Link]*
+*   *[Link to Google PageSpeed Insights]*
+*   *[Link to Image Optimization Tool]*
+
+## Additional Notes
+
+[**Include any additional information or context that may be helpful.**]
+
+*Example: "This issue is related to the ongoing project to improve website performance. Ensure that all changes are thoroughly tested before being deployed to production."*
+
+## Assignee
+
+[**Assign this issue to the appropriate person or team.**]
+
+## Labels
+
+[**Add relevant labels to categorize the issue (e.g., "performance," "optimization," "image").**]