fs-claude-plugin: Instructions file for Claude Code

CLAUDE.md

fs-claude-plugin CLAUDE.md is an instructions file for Claude Code, Codex from FacturaScripts/fs-claude-plugin. It costs 1,766 tokens per session, scanned B, original, MIT.

A project instruction file for Claude Code and Codex, covering repository rules, trusted sources, architecture, and specialist skills.

In plain words
What is it for?
Use it to guide development tasks in the FacturaScripts plugin repository and to prevent unauthorised commits, publication, or exposure of sensitive settings.
Why use it?
It gives coding agents consistent boundaries for where they may work, what they may change, and how they should verify project-specific behavior.

Instructions file for Claude CodeCodex

Written for Claude Code and Codex: ${CLAUDE_PLUGIN_ROOT} variable, but also reads ~/.codex or $CODEX_HOME. Also seen: mentions Claude Code; mentions Codex.

This is FacturaScripts/fs-claude-plugin's own configuration. It tells Claude Code and Codex how to work on fs-claude-plugin itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything fs-claude-plugin configures →

Not installable: its command points at a path on the author’s own machine, so it runs nowhere else. The line is /Users/daniel89fg/Trabajos/FacturaScripts/facturascripts.

Reuse

Borrowing it

Nothing to install: this file belongs to FacturaScripts/fs-claude-plugin. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/FacturaScripts/fs-claude-plugin/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/FacturaScripts/fs-claude-plugin

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for fs-claude-plugin CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/facturascripts/fs-claude-plugin/claude-md/github.svg)](https://agentmods.dev/instructions/facturascripts/fs-claude-plugin/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/facturascripts/fs-claude-plugin/claude-md"><img src="https://agentmods.dev/badge/instructions/facturascripts/fs-claude-plugin/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for fs-claude-plugin CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/facturascripts/fs-claude-plugin/claude-md"><img src="https://agentmods.dev/badge/instructions/facturascripts/fs-claude-plugin/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 1,766 This file is loaded in full into every session.
When invoked 1,766 The same file — it is already loaded in full.
Security scan B 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.01766 $0.01766
Opus 5 $0.00883 $0.00883
Sonnet 5 $0.00353 $0.00353
Haiku 4.5 $0.00177 $0.00177

Measured 2d ago against content hash 11f5a4830544, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-13, from the pricing page.

Security

Grade B, and why

fs-claude-plugin CLAUDE.md scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

- No edites manualmente `~/.codex/config.toml`, caches de plugins ni archivos de marketplace del usuario para simular una actualización.
CLAUDE.md · 95 lines

How it starts

The opening of the file, as written. The whole thing — 95 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Instrucciones del proyecto para Claude Code y Codex

Este repositorio distribuye los plugins fs-dev, fs-user y fs-mcp de FacturaScripts. Aunque el repositorio conserva el nombre fs-claude-plugin, el código debe funcionar tanto en Claude Code como en Codex.

Reglas generales

  • Trabaja únicamente dentro de este repositorio, salvo que el usuario autorice expresamente otra carpeta.
  • Nunca crees commits, ramas, tags, pushes ni publicaciones sin una petición expresa del usuario.
  • Conserva los cambios ajenos presentes en el árbol de trabajo y no reviertas archivos que no formen parte de la tarea.
  • No expongas tokens, credenciales ni el contenido sensible de ~/.fs-claude.json.
  • No crees archivos temporales, informes de auditoría o resúmenes dentro del repositorio salvo que el usuario pida expresamente conservarlos. Comunica los resultados en el chat.

Fuentes de verdad

  • Para verificar clases y patrones de FacturaScripts, consulta el código local en /Users/daniel89fg/Trabajos/FacturaScripts/facturascripts.
  • Para comportamiento específico de Claude Code, consulta la documentación vigente en https://code.claude.com/docs/.
  • Para comportamiento específico de Codex, consulta la documentación oficial vigente en https://developers.openai.com/codex/ y https://learn.chatgpt.com/docs/.
  • No supongas que una característica de un host existe en el otro. Verifica especialmente hooks, agentes, variables de entorno, manifiestos, instalación y recarga.

Arquitectura compartida

  • Mantén un único marketplace y un único código fuente para ambos hosts. No crees un plugin paralelo para Codex salvo que una limitación técnica demostrada haga imposible compartir la implementación y el usuario acepte la separación.
  • Conserva los identificadores fs-dev, fs-user, fs-mcp y el marketplace fs-claude-plugin.
  • Conserva ~/.fs-claude.json como configuración compartida por retrocompatibilidad.
  • La matriz actual de compatibilidad está en COMPATIBILITY.md. Actualízala únicamente cuando cambien capacidades, limitaciones o el flujo de recarga.

Read the full file on GitHub · 95 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 95 lines · 1,766 tokens per session scan B 11f5a4830544

Subscribe to this mod's changes

fs-claude-plugin CLAUDE.md is an instructions file published in the GitHub repository FacturaScripts/fs-claude-plugin (8 stars, last pushed 2d ago), licensed MIT. It adds 1,766 tokens to every session, about $0.0088 per session on Opus 5. A static security scan graded it B with 1 finding (reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-11.

Related

Other instructions, from other repositories

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 6,785 tokens

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,296 tokens

codex AGENTS.md

AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.

openai/codex · 5,153 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).

microsoft/vscode · 5,001 tokens

spec-kit AGENTS.md

AGENTS.md instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.

github/spec-kit · 7,126 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,469 tokens