blockedpath-skills 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Blockedpath
+
+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/README.md

@@ -0,0 +1,57 @@
+# blockedpath-skills
+
+[![Validate marketplace](https://github.com/BlockedPath/Skills/actions/workflows/validate.yml/badge.svg)](https://github.com/BlockedPath/Skills/actions/workflows/validate.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+A plugin marketplace containing skills and plugins for [Claude Code](https://claude.com/claude-code) and [Codex](https://developers.openai.com/codex).
+
+## Installation
+
+### Quick install (npx)
+
+```
+npx blockedpath-skills
+```
+
+Detects whichever of Claude Code / Codex you have installed, adds this marketplace, and installs the available plugins.
+
+### Claude Code
+
+```
+/plugin marketplace add BlockedPath/Skills
+/plugin install x-article-to-markdown@blockedpath-skills
+```
+
+See [Claude Code plugin marketplaces](https://code.claude.com/docs/en/plugin-marketplaces).
+
+### Codex
+
+```
+codex plugin marketplace add BlockedPath/Skills
+```
+
+Then open the plugins directory (`codex /plugins`), select `blockedpath-skills`, and install `x-article-to-markdown`. See [Codex plugins](https://developers.openai.com/codex/plugins).
+
+## Plugins
+
+### x-article-to-markdown
+
+Scrapes an X (Twitter) long-form Article into a local Markdown file, faithfully preserving its structure (headings, formatting, lists, blockquotes, links) and downloading images for offline viewing. X Articles are login-gated and client-rendered, so this skill drives your already-logged-in Chrome via the DevTools protocol.
+
+See [plugins/x-article-to-markdown/skills/x-article-to-markdown/SKILL.md](plugins/x-article-to-markdown/skills/x-article-to-markdown/SKILL.md) for details.
+
+## Repository structure
+
+```
+package.json                       # npx installer (`npx blockedpath-skills`)
+bin/install.js
+.claude-plugin/marketplace.json    # marketplace catalog (Claude Code; also read by Codex as a legacy path)
+plugins/
+  <plugin-name>/
+    package.json                   # optional: publish plugin to npm as an alternate source
+    .claude-plugin/plugin.json     # plugin manifest for Claude Code
+    .codex-plugin/plugin.json      # plugin manifest for Codex
+    skills/<skill-name>/SKILL.md   # skill definition, shared by both
+```
+
+To add a new plugin, create a directory under `plugins/` with its own `.claude-plugin/plugin.json` and `.codex-plugin/plugin.json`, then add an entry to `.claude-plugin/marketplace.json`.

package/bin/install.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+'use strict';
+
+const { spawnSync } = require('child_process');
+
+const MARKETPLACE_REPO = 'BlockedPath/Skills';
+const MARKETPLACE_NAME = 'blockedpath-skills';
+const PLUGINS = ['x-article-to-markdown'];
+
+function commandExists(cmd) {
+  const result = spawnSync(cmd, ['--version'], { stdio: 'ignore' });
+  return !result.error;
+}
+
+function run(cmd, args) {
+  console.log(`\n$ ${cmd} ${args.join(' ')}`);
+  const result = spawnSync(cmd, args, { stdio: 'inherit' });
+  return result.status === 0;
+}
+
+let found = false;
+
+if (commandExists('claude')) {
+  found = true;
+  console.log('== Claude Code ==');
+  run('claude', ['plugin', 'marketplace', 'add', MARKETPLACE_REPO]);
+  for (const plugin of PLUGINS) {
+    run('claude', ['plugin', 'install', `${plugin}@${MARKETPLACE_NAME}`]);
+  }
+} else {
+  console.log('Claude Code CLI not found, skipping (https://claude.com/claude-code)');
+}
+
+if (commandExists('codex')) {
+  found = true;
+  console.log('\n== Codex ==');
+  run('codex', ['plugin', 'marketplace', 'add', MARKETPLACE_REPO]);
+  console.log(
+    `\nMarketplace added. Run "codex /plugins" to install: ${PLUGINS.join(', ')}`
+  );
+} else {
+  console.log('Codex CLI not found, skipping (https://developers.openai.com/codex)');
+}
+
+if (!found) {
+  console.error(
+    '\nNeither the Claude Code nor Codex CLI was found on your PATH. ' +
+      'Install one of them first, then re-run this command.'
+  );
+  process.exit(1);
+}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "blockedpath-skills",
+  "version": "1.0.0",
+  "description": "Installer for the blockedpath-skills plugin marketplace (Claude Code & Codex)",
+  "license": "MIT",
+  "bin": {
+    "blockedpath-skills": "bin/install.js"
+  },
+  "files": [
+    "bin"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BlockedPath/Skills.git"
+  },
+  "homepage": "https://github.com/BlockedPath/Skills",
+  "keywords": [
+    "claude-code",
+    "codex",
+    "plugin-marketplace",
+    "claude",
+    "skills"
+  ]
+}