meta/fboss

Latest recorded source activity: October 30, 2026 at 18:49

SkillsMP catalog refreshed: November 9, 2026 at 14:22

skills collected: 9

GitHub stars: 1,002
GitHub forks: 417

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/meta/fboss.

Repository README

Repository README source: README.md

Read the source README

Expand full README

Facebook Open Switching System (FBOSS) -------------------------------------- FBOSS is Facebook's software stack for controlling and managing network switches. ## Components FBOSS consists of a number of user-space applications, libraries, and utilities. The initial open source release of FBOSS consists primarily of the agent daemon, but we are working on releasing additional pieces and functionality as well. ### Agent Daemon One of the central pieces of FBOSS is the agent daemon, which runs on each switch, and controls the hardware forwarding ASIC. The agent daemon sends forwarding information to the hardware, and implements some control plane protocols such as ARP and NDP. The agent provides thrift APIs for managing routes, to allow external routing control processes to get their routing information programmed into the hardware forwarding tables. The code for the agent can be found in fboss/agent The agent requires a JSON configuration file to specify its port and VLAN configuration. Some sample configuration files can be found under fboss/agent/configs. These files are not really intended for human consumption--at Facebook we have tooling that generates these files for us. ### Routing Daemon The FBOSS agent manages the forwarding tables in the hardware ASIC, but it needs to be informed of the current routes via thrift APIs. Our initial open source release does not yet contain a routing protocol daemon capable of talking to the agent. The routing protocol daemon we use at Facebook is rather specific to our environment, and likely won't be as useful to the open source community. For more general use outside of Facebook, it should be possible to modify existing open source routing tools to talk to the FBOSS agent, but we have not implemented this yet. In the meantime, we have included a small sample python script in fboss/agent/tools that can manually add and remove routes. ### Management Tools Obviously additional tools and utilities are required for interacting with the FBOSS agent, reporting its status, generating configuration files, and debugging issues. At the moment we do not have many of our tools ready for open source release, but we hope to make more of these available in the future weeks. In the meantime, the thrift compiler can automatically generate a python-remote script to allow manual invocation of the agent's various thrift interfaces. ## Building See the BUILD.md document for instructions on how to build FBOSS. ## Future Development FBOSS has been designed specifically to handle the needs of Facebook's data center networks, but we hope it can be useful for the wider community as well. However, note that this initial release of FBOSS will likely require modification and additional development to support other network configurations beyond the features used by Facebook. Until it matures more, FBOSS will likely be primarily of interest to network software developers, rather than to network administrators who are hoping to use it as an turnkey solution. We look forward to getting feedback from the community, and we hope FBOSS can serve as a jumping-off point for other users wishing to program network switches. FBOSS development is ongoing at Facebook, and we plan to continue releasing more components, additional features, and improvements to the existing tooling. ## License See [LICENSE](LICENSE).

Loading the repository README…

Skills in this repository

classification pending

skill

occupation

description

updated

fboss-review

unclassified

Comprehensive FBOSS code review with 11 parallel reviewers (5 generic + 6 FBOSS-specific). Covers reliability, engineering, code quality, silent failures, agent architecture, SAI/SDK, FSDB/thrift_cow, platform/config, testing, and cross-cutting design.…

2026-10-30

fboss-code-standards

unclassified

FBOSS coding standards and patterns. Auto-loaded when writing code in fboss/ to catch architecture violations, SAI/SDK misuse, thrift_cow pitfalls, platform config errors, and testing gaps. For explicit multi-reviewer review, use /fboss-review instead.

2026-10-27

add-config-cli-oss

unclassified

Implement a new `fboss2-dev config <area> <attr> <value>` CLI command family mapping to `SwitchConfig` attributes. Figures out the correct action level (HITLESS / AGENT_WARMBOOT / AGENT_COLDBOOT), wires the handler through the full registration + build graph,…

2026-10-27

fboss-transceiver-npi

unclassified

Use when onboarding a new transceiver NPI end-to-end or partially — adding transceiver code, firmware, and/or conveyor nodes. Trigger phrases: new transceiver NPI, onboard transceiver, add firmware, conveyor nodes, HAL test node, link test config, new optic.…

2026-09-25

fboss-agent-platform-onboarding

unclassified

Use when planning, implementing, or reviewing a new FBOSS hardware platform for wedge_agent, including PlatformType registration, platform descriptor and mapping inputs, generic SAI platform selection, ASIC traits, or exceptional platform-specific behavior.

2026-09-23

fboss-distro-image

unclassified

Interactively plan, explain, and optionally execute FBOSS OSS Distro image workflows. Default to providing commands without running them; execute only when the user explicitly asks. Use whenever a user asks about the `fboss-image` CLI, distro manifests,…

2026-09-23

hw-test-dedup

unclassified

Find and remove redundant FBOSS agent_hw_tests without losing coverage. Use when asked to reduce/combine/dedup HW tests, retire non-dataplane (set/get) tests where dataplane tests exist, or cut HW test runtime while keeping coverage. Report-first; applying…

2026-09-21

link-log-diagnosis

unclassified

Diagnose link flaps from wedge_agent and qsfp_service logs — determine software vs hardware root cause, point to evidence, suggest fixes or detection strategies

2026-09-18

bisect-triage

unclassified

Triage a failing FBOSS test by bisecting commits and investigating code changes. Use when a test is broken and you need to find the commit that caused the failure.

2026-02-13

Showing 9 of 9 collected skills.