A

adsctl

imre-nagi/adsctl · v0.14.1 · Tools & Integrations

by Imre NagiOwner verifiedScan grade: GoodAwesome AI Plugins

Plugin bundling three agent skills that drive a CLI for auditing, monitoring, and managing Meta ad campaigns with explicit account scope

Follow0
Protect this install with HOL Guard

Guard checks the skills and MCP servers a plugin adds on your machine and asks you before a risky action runs. The scores above are free, and no plan changes them.

Is adsctl a fit?

From the plugin's manifest and HOL's scan. Anything the plugin does not declare is shown as not declared.

Works with

  • Codex
  • Claude Code
  • Agent Plugin
  • 3 skills

Before you install

Sign-in
Not declared
Declared access
Read, Write
License
Not declared

Check before relying on it

  • Some security checks did not finish: Cisco skill scan. See the evidence
  • 1 high or critical finding from the scan. See the evidence
  • No license declared in the manifest.

What is adsctl?

adsctl is a published tools & integrations plugin for AI coding agents that works with Codex, Claude Code and Agent Plugin, developed by Imre Nagi and distributed through the HOL AI plugin registry. Plugin bundling three agent skills that drive a CLI for auditing, monitoring, and managing Meta ad campaigns with explicit account scope.

Canonical slug
imre-nagi/adsctl
Version
v0.14.1 · updated Nov 11, 2026

Registry snapshot

Owner verification
Verified on HOL as @imrenagi
Marketplace source
.claude-plugin/marketplace.json
Scanner
HOL plugin scanner
Security result
Needs review
Digest verified
Yes
3 bundled skillsRead, copy or download each SKILL.mdOpen skills

Trust and security

Trust & reputation

On-Chain Verified
35

HOL Trust Score

Per-metric points (0–100 each) combined via a weighted average into the overall score.

Installability
100/100
Maintenance
85/100
MCP server setup
100/100
Plugin Security
81/100
Provenance
80/100
Publisher Quality
100/100

Provenance

Plugin root
.
Source repo
https://github.com/imrenagicom/adsctl
Source commit
c244f0da6536…
Publisher verified
Yes
Owner verified
@imrenagi
Agent Plugins 1.0
Not detected

Continuous scanner CI not detected

This plugin remains listed. Its overall trust score is reduced by 10% because security checks are not maintained in the source repository's CI.

Optional: maintain the scanner in the source repository's CI to receive the full trust score. Listing does not require that change.

README badge not detected

Plugin owners can add the HOL badge to the repository README from Guard Plugins. Distribution, not security evidence. It adds a 2% engagement adjustment to the overall trust score and never changes the security result.

Needs review
Security result
81
Security score
1
High findings
Provider
codex-plugin-scanner
Grade
B · Good
Version
3.24.2
codex:hol-plugin-scanner-N2cCkC / cisco-skill-scanner: failedcodex:hol-plugin-scanner-N2cCkC / cisco-mcp-scanner: skipped

[claude:.] Claude Plugin

18/18

5 checks

[claude:.] Security

13/16

6 checks

[claude:.] Operational Security

3/6

5 checks

[claude:.] Code Quality

10/10

2 checks

[codex:.] Manifest Validation

24/31

9 checks

[codex:.] Security

13/16

9 checks

[codex:.] Operational Security

3/6

5 checks

[codex:.] Best Practices

9/12

5 checks

[codex:.] Marketplace

15/15

3 checks

[codex:.] Skill Security

0/5

4 checks

[codex:.] Code Quality

10/10

2 checks

Published advisories

None matched in GitHub security advisories, checked . This covers published advisories only, not problems nobody has reported.

GitHub security advisories are those the source repository has published.

Findings

highskill-securityRISKY_SKILL_INSTRUCTION

The skill includes "curl -fsSL https://github.com/imrenagicom/adsctl/releases/latest/download/install.sh" and uses curl with uploads, shell composition, or arguments requiring review.

Remove instructions that read sensitive local files, launch shell wrappers, or send workspace data to remote endpoints.

lowsecuritySECURITY_MD_MISSINGReported 2 times

Plugins should publish a SECURITY.md file for responsible disclosure and support guidance.

Add a SECURITY.md file with reporting guidance and supported versions.

lowoperational-securityDEPENDABOT_MISSINGReported 2 times

Automation or dependency surfaces exist, but .github/dependabot.yml is missing.

Add Dependabot updates for GitHub Actions and dependency manifests.

infomanifest-validationPLUGIN_JSON_RECOMMENDED_LICENSE

The manifest is missing the documented recommended field "license".

Add "license" to strengthen the plugin manifest metadata.

infomanifest-validationPLUGIN_JSON_INTERFACE_ASSET_WEBSITEURL

The interface field "websiteURL" must use HTTPS or point to a safe in-repo asset.

Update "websiteURL" to use HTTPS or an existing relative asset path.

infomanifest-validationPLUGIN_JSON_INTERFACE_ASSET_PRIVACYPOLICYURL

The interface field "privacyPolicyURL" must use HTTPS or point to a safe in-repo asset.

Update "privacyPolicyURL" to use HTTPS or an existing relative asset path.

infomanifest-validationPLUGIN_JSON_INTERFACE_ASSET_TERMSOFSERVICEURL

The interface field "termsOfServiceURL" must use HTTPS or point to a safe in-repo asset.

Update "termsOfServiceURL" to use HTTPS or an existing relative asset path.

infomanifest-validationPLUGIN_JSON_INTERFACE_ASSET_COMPOSERICON

The interface field "composerIcon" must use HTTPS or point to a safe in-repo asset.

Update "composerIcon" to use HTTPS or an existing relative asset path.

infomanifest-validationPLUGIN_JSON_INTERFACE_ASSET_LOGO

The interface field "logo" must use HTTPS or point to a safe in-repo asset.

Update "logo" to use HTTPS or an existing relative asset path.

infomanifest-validationPLUGIN_JSON_INTERFACE_ASSET_SCREENSHOTS

The interface field "screenshots" must use HTTPS or point to a safe in-repo asset.

Update "screenshots" to use HTTPS or an existing relative asset path.

infobest-practicesCODEXIGNORE_MISSING

A .codexignore file helps prevent accidental inclusion of local artifacts and secrets.

Add a .codexignore file with generated assets, local state, and secret paths.

Install guidance

Install in Claude Code

Install through the Claude Code plugin marketplace.

Claude Code plugin docs

Optional: install HOL Guard for Claude Code first, so it can check this plugin's tools on your machine before Claude Code uses them.

  1. 1

    Add the marketplace

    Run this inside a Claude Code session. It registers the marketplace manifest shipped at the repository root. If the repository ships none, add the generated entry from the Advanced section below first.

    claude code
  2. 2

    Install the plugin

    Installs the adsctl entry from the adsctl marketplace.

    claude code
  3. 3

    Scripted alternative

    Non-interactive equivalent for scripts and CI pipelines. Add --scope project to pin the install to one repository.

    shell
  4. 4

    Check it is installed

    Lists installed plugins. The entry should appear as enabled.

    shell

To remove it later, run claude plugin uninstall adsctl@adsctl.

Did setup work in Claude Code?

No setup reports for Claude Code yet. Self-reported by signed-in visitors. Copying a command is not counted, and most installs are never reported.

Attested installs: Fewer than 10 attested installs of this plugin in week 2026-W46, so no number is shown. Counted from opt-in HOL Guard install reports, once per machine and runtime, and never mixed with the answers above. How install reports work.

Loading reviews

Plugin manifest

{
  "name": "adsctl",
  "version": "0.14.1",
  "description": "Set up adsctl and inspect, audit, report on, monitor, and manage Meta advertising with explicit account scope.",
  "author": {
    "name": "Imre Nagi"
  },
  "homepage": "https://github.com/imrenagicom/adsctl",
  "repository": "https://github.com/imrenagicom/adsctl",
  "keywords": [
    "adsctl",
    "meta",
    "advertising",
    "reporting",
    "analytics"
  ],
  "skills": "./",
  "requires_local_executor": true,
  "extensions": {
    "com.openai": {
      "onboardingSkill": "./skills/adsctl-setup/SKILL.md"
    }
  },
  "interface": {
    "displayName": "adsctl",
    "developerName": "Imre Nagi",
    "shortDescription": "Set up, audit, and manage Meta ads",
    "longDescription": "Install the adsctl CLI, configure external Meta credentials, audit campaign funnel performance, and carry out explicitly scoped management and campaign launch workflows.",
    "category": "Productivity",
    "capabilities": [
      "Read",
      "Write"
    ],
    "defaultPrompt": [
      "Use the adsctl setup skill to install the CLI and configure Meta API access.",
      "Use adsctl-meta-analyst to evaluate our running Meta campaign performance and recommend next actions.",
      "Use adsctl to summarize performance for my selected Meta ad account."
    ]
  },
  "holManifestOrigin": "repository",
  "registryIndexVersion": 9
}

Marketplace source

Repo URL
https://github.com/imrenagicom/adsctl
Marketplace path
.claude-plugin/marketplace.json
Source path
.
Install policy
Unspecified

Skills

3 SKILL.md files ship with this plugin. Preview, copy, or download each one, then install them with the Skills CLI.

Share
skills-cli
  • adsctl-meta-analyst

    skills/adsctl-meta-analyst/SKILL.md

    Audit and evaluate Meta advertising campaign performance using adsctl. Run structured diagnostic checks across delivery health, creative hook and video retention, click efficiency, post-click landing page and tracking continuity, placement breakdowns, and conversion economics, then produce evidence-backed recommendations. Use when the user asks how a Meta campaign or ad account is performing, wants a media-buyer audit, asks whether to pause, hold, or scale ads, or needs a diagnostic performance review. Also use when the user asks why performance changed between two periods.

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

  • adsctl-setup

    skills/adsctl-setup/SKILL.md

    Install and configure adsctl, guide users through obtaining Meta Marketing API user or system-user tokens, assign required asset access, and diagnose credential setup failures. Use for adsctl onboarding, credential rotation, or authentication and permission setup; campaign operations and performance analysis belong to the adsctl operations skill.

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

  • adsctl

    skills/adsctl/SKILL.md

    Use the adsctl CLI to inspect Meta ad accounts, query performance and insights, monitor delivery, manage campaigns/ad sets/ads and budgets, upload creative assets, and create or recover campaign launches. Use when the user requests adsctl operations or agent workflows built on adsctl. Meta is currently supported; Google commands are not implemented.

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

File inventory

.agents/plugins/marketplace.json

file

340 bytes

4e138c37b3e2546b…

.claude-plugin/marketplace.json

file

324 bytes

4c9da946f26dccc0…

.claude-plugin/plugin.json

file

407 bytes

3ce94e90c5df8be4…

.codex-plugin/plugin.json

plugin-manifest

1,189 bytes

fb79be38e15b9b89…

go.mod

file

280 bytes

be3b0fbba8fdf621…

go.sum

file

1,408 bytes

5e0b1445dac24623…

LICENSE

file

1,424 bytes

fea6a05fbed9613d…

package-lock.json

file

193,104 bytes

470e58075337d5ce…

package.json

file

625 bytes

5e01be077b8ab50d…

plugin.json

file

567 bytes

38a01cad753393d7…

README.md

file

23,334 bytes

4b601fc03198913a…

skills/adsctl-meta-analyst/agents/openai.yaml

skill

288 bytes

35d3620757981be6…

skills/adsctl-meta-analyst/references/change-investigation.md

skill

8,039 bytes

e035eb3f4019358a…

skills/adsctl-meta-analyst/references/diagnostic-playbook.md

skill

12,539 bytes

04a3c73da8d825d7…

skills/adsctl-meta-analyst/references/metrics-and-benchmarks.md

skill

16,331 bytes

d9d25f35e245526c…

skills/adsctl-meta-analyst/SKILL.md

skill

11,274 bytes

a8bd1ca8d53e7e53…

skills/adsctl-setup/agents/openai.yaml

skill

111 bytes

c9cb4752b0fd609c…

skills/adsctl-setup/references/meta-credentials.md

skill

11,577 bytes

e69b57a420facefd…

skills/adsctl-setup/SKILL.md

skill

9,007 bytes

3c72e50e82a3ac3f…

skills/adsctl/agents/openai.yaml

skill

229 bytes

8f6f7ff86f0b9751…

skills/adsctl/references/instagram.md

skill

8,691 bytes

9c4d4156a880c357…

skills/adsctl/references/management.md

skill

12,090 bytes

1a81b739ad2e260a…

skills/adsctl/references/reporting.md

skill

6,446 bytes

beef269da292070f…

skills/adsctl/SKILL.md

skill

6,009 bytes

332dd4717fe9b2b5…

adsctl — Frequently asked questions

What is adsctl?
adsctl is an AI plugin in the HOL registry. Plugin bundling three agent skills that drive a CLI for auditing, monitoring, and managing Meta ad campaigns with explicit account scope.
How do I install adsctl?
Install adsctl in your harness: Codex — codex plugin marketplace add imrenagicom/adsctl; Claude Code — /plugin marketplace add imrenagicom/adsctl; Any agent — npx [email protected] add imrenagicom/adsctl. Full step-by-step guidance is on the HOL plugin page.
How do I install adsctl in HOL Guard?
To install adsctl in HOL Guard, start with hol-guard plugin install imre-nagi/adsctl --apply. The complete step-by-step install guide for HOL Guard is on the HOL plugin page.
How do I install adsctl in Codex?
To install adsctl in Codex, start with codex plugin marketplace add imrenagicom/adsctl. The complete step-by-step install guide for Codex is on the HOL plugin page.
How do I install adsctl in Claude Code?
To install adsctl in Claude Code, start with /plugin marketplace add imrenagicom/adsctl. The complete step-by-step install guide for Claude Code is on the HOL plugin page.
How is the Trust Score for adsctl computed?
adsctl has a HOL Trust Score of 35 out of 100. The score is a weighted sum of six components from a static scan of the source, capped for high-severity findings and adjusted by two disclosed policies. Memberships and payments are not inputs, and a scan is not a safety guarantee. Full breakdown: https://hol.org/registry/plugins/imre-nagi%2Fadsctl/trust
Who publishes adsctl?
adsctl is published by Imre Nagi and listed on HOL.

Directory acceptance

Listed in 0 of 5 directory lists

Read from the list each directory publishes on GitHub. Being listed means the directory accepted the plugin; it is not a HOL security rating.

Lists last read . HOL re-reads them every day.

Submitting it? Check it against each directory's rules

Install signal

HOL cannot see every install. These are separate signals from different sources, so they are not added together. Counts under each floor show as <N.

Install commands issued here
<5
HOL Guard install commands issued from this listing, last 28 days.
Opt-in install reports
<10
Machines that reported installing it through HOL Guard in week 2026-W46. Reporting is opt-in, so most installs are not counted.
HOL Guard workspaces
<5
Workspaces that approved it or include it in an approved-plugin feed, as of today.

Reviews and similar plugins