npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@app-protocol/skill-app

v1.1.6

Published

Canonical /app skill package for applying the APP protocol in real projects across Codex, Claude, GitHub Copilot, Windsurf, and compatible hosts.

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

jhenriquedevjhenriquedev

Keywords

appai-first-programmingskillcodexclaudecopilotwindsurf

Readme

@app-protocol/skill-app

Install, update, downgrade, and remove the canonical /app skill for APP projects.

/app is the canonical skill for applying the APP protocol in real projects. APP is the protocol layer of the AI-First Programming Paradigm.

What this package does

This package installs the official /app operational workflow into supported AI coding hosts so they can:

  • inspect APP architecture
  • set up a new APP project
  • add a new host app such as backend, portal, agent, worker, or lambdas
  • create or update Cases
  • introduce packages/ and expose them correctly through host registries
  • classify whether shared code belongs in cases/, packages/, or core/shared/
  • implement domain, api, ui, web, mobile, stream, and agentic surfaces
  • maintain <case>.us.md
  • validate APP grammar
  • review structural drift
  • adapt existing projects to APP incrementally

The installed package includes both SKILL.md and an adjacent spec.md copy so hosts can read the operational profile and the normative protocol together.

For generic app-level agentic hosts, the canonical host name is agent. Names such as chatbot are reserved for explicitly conversational specializations.

Supported hosts

The package installs the app skill into native skill directories for:

  • Codex
  • Claude
  • GitHub Copilot
  • Windsurf
  • other Agent Skills-compatible hosts through .agents/skills

Project-local targets:

  • .codex/skills/app/
  • .claude/skills/app/
  • .github/skills/app/
  • .windsurf/skills/app/
  • .agents/skills/app/

Validate the package

npx @app-protocol/skill-app validate

CLI help

List all commands, host aliases, examples, and compatibility notes:

npx @app-protocol/skill-app --help
app-skill --help

Print only the CLI version:

npx @app-protocol/skill-app --version
npx @app-protocol/skill-app -v
app-skill version
app-skill --version
app-skill -v

Check whether the installed skill is behind the latest published npm version:

npx @app-protocol/skill-app outdated all --project .
app-skill outdated codex --global

Quick start

npx @app-protocol/skill-app install all --project .

Then use prompts such as:

inspect this project with /app
set up a new APP project with /app
add an agent host app using /app
create case usuario_criar
validate app grammar in this repository
adapt this existing project to APP incrementally

Install into the current project

npx @app-protocol/skill-app install all --project .

Install only for one host:

npx @app-protocol/skill-app install codex --project .
npx @app-protocol/skill-app install claude --project .
npx @app-protocol/skill-app install copilot --project .
npx @app-protocol/skill-app install windsurf --project .
npx @app-protocol/skill-app install agents --project .

Install globally

npx @app-protocol/skill-app install codex --global
npx @app-protocol/skill-app install claude --global
npx @app-protocol/skill-app install copilot --global
npx @app-protocol/skill-app install windsurf --global
npx @app-protocol/skill-app install agents --global

Update an existing install

npx @app-protocol/skill-app update all --project .
npx @app-protocol/skill-app update copilot --global

Upgrade or downgrade by package version

npx @app-protocol/skill-app upgrade all --project .
npx @app-protocol/skill-app downgrade all --project . --version 0.0.9
npx @app-protocol/skill-app install all --project . --version 0.0.9

upgrade installs npm latest by default, but now skips the operation when the installed version is already newer or equal. downgrade requires --version and skips the operation when the installed version is already lower or equal. install and update also accept --version when you want an explicit published version.

Remove an installed skill

npx @app-protocol/skill-app uninstall all --project .
npx @app-protocol/skill-app uninstall windsurf --global

Install the CLI with npm

npm install --global @app-protocol/skill-app
app-skill --help
app-skill --version
app-skill validate
app-skill outdated all --project .
app-skill install all --project .

Platform compatibility

The installer is designed to work on:

  • macOS
  • Linux
  • Windows

Compatibility notes:

  • it uses Node.js standard library APIs for path resolution and file operations
  • global and project-local install targets are built with path.join, not shell-specific path concatenation
  • npm invocation uses a Windows-specific fallback so npm.cmd-style launchers work on win32
  • no Unix-only shell commands are required by the installer itself

Release tarball fallback

npm exec --yes --package https://github.com/jhenriquedev/app-protocol/releases/download/vX.Y.Z/app-protocol-skill-app-X.Y.Z.tgz app-skill -- install all --project .

What /app is for

Use /app when working in APP projects to:

  • inspect project structure and explain APP topology
  • set up a new APP project
  • add a new host app
  • create or update Cases
  • introduce packages/
  • classify shared code across cases/, packages/, and core/shared/
  • implement or revise surfaces
  • maintain <case>.us.md
  • validate APP grammar
  • review structural drift
  • adapt existing projects incrementally

More documentation